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certified to comply with the Class B limits may be 
attached to the computer. Operation with 
non-certified peripherals is likely to result in 
interference to radio and TV reception. If 
peripherals not offered by IBM are used with the 
equipment, it is suggested to use shielded grounded 
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This equipment generates and uses radio frequency 
energy and if not installed and used properly, i.e., in 
strict accordance with the operating instructions, 
reference manuals, and the service manual, may cause 
interference to radio or television reception. It has been 
tested and found to comply with the limits for a Class B 
computing device pursuant to Subpart J of Part 15 of 
FCC Rules, which are designed to provide reasonable 
protection against such interference when operated in a 
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If this equipment does cause interference to radio or 
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• Relocate the equipment with respect to the receiver. 

• Move the equipment away from the receiver. 
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. If peripherals not offered by IBM are used with this 
equipment, it is suggested that you use shielded, 
grounded cables with in-line filters, if necessary. 

If necessary, consult your dealer service representative 
for additional suggestions. 

The manufacturer is not responsible for any radio or 
TV interference caused by unauthorized modifications 
to this equipment. It is the responsibility of the user to 
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The product described herein is equipped with a 
grounded plug for the user’s safety. It is to be used 
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About This Book 


The IBM PC Network Technical Reference provides 
network design information on the components that 
comprise the IBM PC Network, and information on the 
fundamentals of designing an IBM PC Network. This 
book also includes the IBM PC Network Adapter Basic 
Input Output System (BIOS) interface with listings. 

This book is written for engineers, programmers, 
telecommunications professionals, and those interested 
in how the IBM PC Network is designed. 


How This Book is Organized 

This book has four chapters and five appendixes: 
Chapter 1 is an introduction to the IBM PC Network: 

• What the IBM PC Network is 

• What the IBM PC Network does for you 

Chapter 2 is a detailed reference about the software for 
the IBM PC Network adapter: 

• Network software layers 

• IBM PC Network software Network Control Block 
(NCB) commands 
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Chapter 3 is a detailed description of each of the IBM 
PC Network components: 

• PC Network Adapter 

• Translator Unit 

• PC Network Cable System 

Chapter 4 discusses the fundamentals of network 
design: 

• How to calculate network parameters to obtain the 
desired signal levels 

• Configuration considerations 

• Available tools 

Appendix A; IBM PC Network adapter and The IBM 
Translator Unit schematics 

Appendix B. Tables of IBM PC Network specifications 

Appendix C. The IBM PC Network protocols and 
pseudo code for the NCB commands 

Appendix D. Adapter BIOS listings 

Appendix E. Multitasking considerations 

Glossary of Terms 

Bibliography 



IBM Personal Computer program license 
agreements permit the use of a program on a single 
machine. The customer is responsible for ensuring 
that each system user in the network is 
appropriately licensed to use any programs shared 
over the network. 
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What the IBM PC Network Is 


The IBM PC Network is a broadband local area 

network that allows multiple Personal Computers to 

communicate with each other. 

Some of the major features of the IBM PC Network are 

as follows: 

• Many types of IBM Personal Computers can be 
connected to the network with an IBM PC 
Network Adapter in each computer. 

• Each IBM PC Network Adapter is a highly 
intelligent device that can communicate on a single 
coaxial cable at a data rate of 2 million bits per 
second. 

• The circuitry on the adapter includes an Intel™ 
80188 microprocessor, an Intel 82586 
communications controller, and other related 
circuitry. 

• The IBM PC Network cable kit components can be 
used to simplify the installation of the IBM PC 
Network. A fully extended network using IBM 
components supports data transmissions for up to 
72 nodes within a 1000 foot radius. 

• You can choose to design your own data and video 
cable network. The network can contain up to 
1000 nodes at a maximum distance of up to 5 
kilometers with the proper cable specifications and 
a commercially available frequency translator. The 
performance of a large network depends on the 
load that is placed on the network by each 
computer. 

• Communication with the IBM PC Network 
Adapter is through a BIOS interface that is 
operating system independent. 
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• The high level BIOS interface and a separate 
processor off-loads work from each computer on 
the network. This high level interface improves the 
computers performance, reduces memory 
requirements, and simplifies programming. 

• The adapter BIOS supports a Remote Program 
Load feature to boot a Personal Computer from a 
remote server computer on the network. 

• The software on the adapter is implemented as 
protocol layers. The software represents a 
broadband implementation of the lower 5 protocol 
layers (physical through session). 

• Communication can occur by addressing other 
computers on the network by using ordinary names 
like John or Mary instead of physical addresses. 


Broadband 

The term broadband is used here to describe a type of 
local area network. Broadband networks are similar to 
Cable TV (CATV) networks in use today. One 
difference between CATV and Broadband networks is 
that CATV systems only transmit many one-way 
frequencies at the same time on a single coaxial cable. 
Broadband networks use different frequencies to 
provide a simultaneous communication link between 
each attached computer. 

Major components used in CATV and broadband 
networks are similar, such as the coaxial cable, 
directional taps, and splitters. The difference is in the 
main component used in both types of networks called 
the frequency translator. This component does what its 
name implies; it translates from one frequency to 
another but leaves the information that is carried by the 
frequency intact. Most of the CATV frequency 
translators in use today do the same thing, but not in a 
bi-directional way like the IBM PC Network. 
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The frequency translator used in the IBM PC Network 
is made up of a frequency translator, a directional tap, 
and an 8-way splitter. These components, when 
connected together, make up what is called the IBM 
Translator Unit. 


Local Area Network 

This term is used to denote the physical size of the 
network. CATV networks, in general, cover part or all 
of an entire city. Broadband networks are limited in 
size to cover a cluster of computers within a building or 
even between buildings, if the cable limitations are not 
exceeded. 

For the IBM PC Network, each computer connects to 
the network by a single coaxial cable connection similar 
to that for CATV. The physical layout of the cable can 
vary from installation to installation. You can think of 
the basic layout as a tree, with the frequency translator 
at the base of the tree. The main cable is the trunk of 
the tree Q. The computers are connected to the main 
cable through branches Q. Each computer on the 
network is referred to as a node Q. Each node 
includes a personal computer, an IBM PC Network 
Adapter, and the necessary software. See Figure 1-1 
for a diagram of a basic network. 
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Figure 1-1 Basic Network Layout 
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The advantage of a tree network is that it continues to 
operate even though one or more of the nodes or 
branches are not active. 

In general, the IBM PC Network is a reliable, efficient 
means to communicate programs, data, and messages 
between two or more computers. The following is a 
brief description of the software and hardware 
components that make up the IBM PC Network. 


Basic Components 

Basic components of the IBM PC Network are: 

• An IBM PC Network Adapter and BIOS with a 
white adapter cable 

• An IBM Translator Unit with connection hardware 

• The IBM Base Expander 

• An IBM Short, Medium, or Long Distance Kit 

• IBM Coaxial Cable in lengths of 25, 50, 100, or 
200 feet 


The IBM PC Network Adapter 

Each computer on the network must have an IBM PC 
Network Adapter. The adapter contains a radio 
frequency (RE) modem, a Basic Input Output System 
(BIOS) ROM, and two processors (Intel 80188 and 
82586), to ensure reliable two-way communication 
with the other computers on the network. The 
hardware portion of the adapter is described in Chapter 
3. In Chapter 2, the BIOS and programming features 
of the IBM PC Network Adapter are detailed. Some of 
the information covered in Chapter 2 is as follows: 

• A layered approach to the network software 


The IBM PC Network 1-7 



Session and datagram support to connect the 
computers together 

Sample programs and aids to programming with 
the BIOS 


The IBM Translator Unit 

All transmissions pass through an electronic device 
called a Translator Unit. The unit receives 
transmissions from the devices attached to the network, 
amplifies them, raises their frequency into a higher 
range, and retransmits them over the same cable. 

Each IBM PC Network must have one Translator Unit. 
The connection hardware that comes with the IBM 
Translator Unit supports up to eight computers. Each 
computer can be located up to 200 feet away from the 
Translator Unit’s eight-way splitter. 


The IBM Base Expander 

Use this device when you need to connect more than 
eight computers to the network or when a distance 
greater than 200 feet between the Translator Unit and a 
computer is required. The Base Expander allows you to 
connect any combination of Short, Medium, or Long 
Distance Kits to the Translator Unit. Up to eight kits 
can be connected to the Base Expander. 


The IBM Short, Medium, or Long Distance 
Kits 

These kits allow you to connect up to eight additional 
computers to the network. Each kit must connect to 
the Base Expander to function properly on the network. 
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There are three types of kits for the IBM PC Network: 
Short, Medium, or Long. Each type of kit is selected 
for the distance you need to locate each computer from 
the Translator Unit. 

• The Short Distance Kit connects directly to the 
Base Expander. Cable can be added between the 
Short Distance Kit and the computer for a distance 
of up to 200 feet. 

• The Medium Distance Kit attaches to the Base 
Expander through 400 feet of cable. This cable 
must be added between this kit and the Base 
Expander for proper operation. Cable can be 
placed between the Medium Distance Kit and the 
computer for a distance of up to 200 more feet. 
The maximum allowable distance for each 
computer using this kit is 600 feet from the 
Translator Unit. 

• The Lor^ Distance Kit connects to the Base 
Expander like the Medium Distance Kit. 800 feet 
of cable must be added between this kit and the 
Base Expander for proper operation. Cable can be 
added between the Long Distance Kit and the 
computer for a distance of up to 200 additional 
feet. The maximum allowable distance for each 
computer using the Long Distance Kit is 1000 feet 
from the Translator Unit. 


Hardware Configuration 

The minimum IBM PC Network configuration consists 
of two computers and one IBM PC Network Translator 
Unit. Both computers contain an IBM PC Network 
adapter, and a 3-meter white adapter cable that 
connects them to the Translator Unit. 

To expand this simple system, you can add up to 6 
more computers. For more distance or more than 8 
computers, you can add IBM cable, the IBM Base 


The IBM PC Network 1-9 



Expander, and any combination of IBM Short, Medium, 
or Long Distance Kits. Also, you must add an IBM PC 
Network Adapter for each computer. 

You can expand the IBM PC Network, with the kits, up 
to a maximum of 72 nodes by installing the hardware 
needed to connect them. See “The IBM PC Network 
Cable System” on page 3-79 for details about using the 
cable kits. 

Because the IBM PC Network is a broadband network, 
you can simultaneously use the network for other 
applications. 

The IBM Translator Unit can only be used on a 
network that transmits and receives data. It does not 
allow or support any of the following functions. To 
support these functions, you must acquire a different 
frequency translator. 

• Additional data channels 

• Video conferencing 

. Closed circuit TV (CCTV) 

• Area and building access control 

• Security and fire alarm systems 

• Energy management and conservation 
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Introduction 


The IBM PC Network is a broadband local area 
network designed to logically and physically connect 
two or more Personal Computers together. The 
software on the adapter presents a high level interface 
to the programmer eliminating the need to know 
network protocol details. This high level interface 
improves system performance by off-loading network 
programs onto the adapter. Also, this off-loading 
feature saves memory because the network programs 
are in the adapter’s memory and not in the Personal 
Computer’s memory. Concepts that are designed 
within the network are as follows: 

• Peer network — This means that each member is 
treated equally and on a first-come, first-served 
basis. There is no "host" concept as in 
telecommunication operations. There are no 
required centralized facilities of any type on the 
network other than the Translator Unit. Peers on 
the network can be connected with a reliable, 
point-to-point connection called a virtual circuit. 

• Names on the network — When each member is 
physically connected to the network, a name is 
given to represent that peer. The names used can 
be general names, such as "John", instead of 
specialized names or numbers. Names can also be 
clustered into logical groups. 

• Session services — After the names for each peer 
are specified, two of the peers communicate with 
each other in a mode called a session. Sessions are 
very similar to a telecommunication reliable 
point-to-point, full-duplex type of connection. For 
the IBM PC Network, a session can also be 
referred to as a virtual circuit. Once the session is 
established, the transfer of data through the 
network can begin. 

• Datagram service — The IBM PC Network also 
supports messages called datagrams. Datagram 
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services do not provide a point-to-point 
connection. The datagrams are only sent once. 
Acknowledgment and retransmissions are the 
responsibility of the user. 
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IBM PC Network Adapter Data 
Transfer 

This section describes the IBM PC Network Adapter 
software. The adapter supports all network and 
software protocol functions to assure that messages and 
data are sent from one computer to another on the 
network. It also provides the mechanism for returning 
command status to the Personal Computer following 
command execution. 

The IBM PC Network adapter supports five layers of 
the data transfer protocols. Each layer comprises one 
or more protocol services. Each layer communicates 
only with the layer immediately above and below it. 

This structure allows a modular design of the protocols. 
The layers supported by the adapter are as follows: 

• Physical layer 

• Link layer 

• Network layer 

• Transport layer 

• Session layer 

The physical layer is implemented using the RE modem 
on the adapter and the interface logic to the Intel 82586 
Communications Controller. For detailed information 
on the physical layer, refer to the Intel 82586 iAPX 
manual and refer to Chapter 3 for the RE Modem logic. 

The link layer is primarily implemented in hardware by 
using the Intel 82586. 

The other three layers (network, transport and session) 
are implemented using the Intel 80188 processor and 
ROMs on the adapter. Also, the layers provide a 
reliable virtual connection service, a name support 
facility, and a low-overhead datagram service. 
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Figure 2-1. 


The following figure provides a general overview of the 
protocol services provided by the Physical, Link, 
Network, Transport, and Session layers. 
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The following description provides a general overview 
of the protocol services provided by the Physical, Link, 
Network, Transport, and Session layers. Detailed 
specifications and standard message formats can be 
found in Appendix C of this book. 


Physical Layer 

The physical layer is implemented in hardware 
providing a 2 Mbit per second physical channel on the 
broadband network through a single-channel RF 
modem. This layer is mostly implemented using the RF 
transmit and receive circuits along with the Sytek Serial 
Interface Controller (SIC). The RF modem transmits 
on one channel and receives on another. 


Link Layer 

The link layer uses a connection-less oriented link layer 
protocol. This link layer protocol is similar in function 
to the IEEE 802.3 medium access control protocol. 

The link layer is largely responsible for assembling the 
bits, transmitted by the network layer or received from 
the physical layer, into data units. When the physical 
layer has received a transmission of bits from the cable, 
it is the responsibility of the link layer to check and 
assemble the bits. 

When the network layer has a packet to transmit, the 
link layer has the responsibility to put the data into the 
correct format and detects any errors that might occur. 
The data units are further organized by either adding or 
removing any necessary start or end bytes. A final 
CRC check is performed on the organized bits. 


CSMA/CD 

One method of regulating transmissions is called a 
channel arbitration protocol. One such protocol is 
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called Carrier Sense, Multiple Access with Collision 
Detection or CSMA/ CD. CSMA/ CD operates in the 
following way: 

The carrier sense multiple access with collision 
detection (CSMA/ CD) technique is used to resolve 
contentions and allows the sharing of the common 
channel on the broadband cable in an orderly and 
equitable manner. 


Carrier Sense 

• Each adapter continuously monitors traffic on the 
channel, even when transmitting. 


Multiple Access 

• Anytime there is a pause on the channel (no one 
transmitting), any device can begin transmitting. 

• If only one device begins transmitting during a 
pause, that device gains control of the channel and 
transmits its messages without interruptions. 

• After that transmission is ended, the channel is 
clear again, and all devices waiting to transmit 
again contend for the channel. 


Collision Detection 

• If two or more devices begin transmitting during 
the same pause, their signals collide and the 
garbled data is detected by both receivers (collision 
detection). 

• When the collision is detected, the devices stop 
transmitting and wait for some random time 
interval before retransmitting. During the time 
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interval before retransmitting, any other device can 
attempt to transmit over the network, using the 
CSMA/ CD protocol. 

The IBM PC Network uses the CSMA/ CD method for 
all data transmissions on the network. 


Network Layer 

The network layer has the responsibility of correctly 
routing the packets. When a message is passed from 
the transport layer, this layer selects the correct routing 
convention for the message. The packet is then passed 
on to the link layer for processing. 

When this layer has received a data unit from the link 
layer, the Network layer determines if the packet is a 
datagram or if it belongs to a virtual connection and 
passes the packet up to the transport layer for further 
processing. 


Transport Layer 

The transport layer primarily has the responsibility of 
creating a reliable point-to-point connection between 
two adapters on the network. This layer supports data 
transmissions and acknowledgments, and handles any 
necessary flow control or pacing required to maintain a 
reliable virtual circuit. This layer transmits messages 
for the session layer using services of the network layer. 


Session Layer 

The session layer presents the adapter interface to the 
network for all Personal Computer programs. 
Responsibilities of this layer include establishing a 
session using two names in the appropriate name tables 
and interpreting commands in the form of a Network 
Control Blocks (NCBs). The concept of an adapter 
being known by many names is implemented in this 
layer. 
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Chapter 2 outlines the specific interface to this layer. 
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Programming The IBM PC Network 
Adapter 


The first section, “IBM PC Network Adapter 
Characteristics”, describes basic concepts of how to 
program your adapter using the IBM PC Network 
Adapter Basic Input Output System (BIOS) and its 
interface to the IBM Personal Computer. Even though 
the network software is composed of many layers, the 
BIOS presents one interface to the user program. 

When programming the adapter, you should use the 
BIOS interface. 

The next section, “Network Control Block (NCB)”, 
describes how to interface your program with the BIOS 
by using a collection of fields to form a NCB. Once a 
command is presented to the BIOS in the NCB format, 
a response is returned to the program in the form of a 
return code. These return codes are also described in 
this section. 

The last section, “Remote Program Load for the IBM 
PC Network”, describes how to program and setup a 
Personal Computer as a program load computer for the 
network. The section also has instructions for the 
sample programs included with this book. 

Before you program, you need to understand some 
additional characteristics of the adapter. 


IBM PC Network Adapter Characteristics 

All of the communication functions from the physical 
layer through the session layer are handled on the 
adapter. 

The BIOS is a software interface between the IBM PC 
Network adapter and the Personal Computer programs. 
The BIOS places the unique features of a local area 
network into a standard format. 
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IBM PC Network security is not built into the BIOS. 
Instead, it is the responsibility of the operating system 
or application program to make sure that data or 
devices are secure on the IBM PC Network. 


Data Transfer 

Two basic types of data transfer are supported. 
Reliable data transfer is provided by the session layer. 
If data is lost or if the line drops, the BIOS will return 
an error code. 

Data transfer using datagram support goes directly to 
the link layer. This type of transfer does not contain 
any features such as those found in the session or the 
transport layer. The most common use of this type of 
data transfer is for broadcast messages. 


Name Support 

You must communicate on the network by using names. 
Each adapter can hold up to 16 selectable names and 1 
permanent node name. Each name has a length of 16 
characters and all 16 characters are always used in a 
name. A permanent name is always present and 
consists of 10 bytes of binary zeros followed by the 
unique adapter unit ID number. The next 16 names can 
be added to the name table. 


Using the Network 

To use the network you must; 

1 . Add your name to the table of names on the 

adapter. This is the name that you are known by 
on the network. Skip this step if you wish to use 
the permanent node name. 
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2. Establish a session with another name on the 
network. This gives you a logical connection with 
another name. The other name can be in your 
name table or in a name table of another adapter. 

3. Send and receive messages using that session. 

As an alternative to session support, you can use 
datagram support. 
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Network Control Block (NCB) 


This section describes how to create an NCB, how to 
handle interrupts, and how to recover from error 
situations. 

Note: The following section assumes that you are 
familiar with assembler language and its concepts. 

Commands are presented to the BIOS in the form of a 
Network Control Block (NCB). The following is the 
basic concept and format to present NCB commands to 
the BIOS: 

1. Build and fill in all required fields of an NCB. 

When you build a new NCB, set all fields to binary 
zeros. See section “NCB Field Description’’ on 
page 2-15 for the required fill character for each 
held. 

2. Allocate any necessary buffers specified in the 
required NCB fields. 

3. Make sure that there are at least 20 bytes of stack 
space left for each outstanding NCB command. 

4. Place the address of the NCB in the ES:BX 
register pair. Issue a software interrupt to vector 
5C hex (i.e. INT 5CH). 

5. Once an NCB is issued. Do Not change or move it 
until it has completed. 

6. After the command is processed, control is 
returned to the caller. The result of the process is 
in either the AL register or the return code field of 
the NCB. 
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NCB Field Description 

The following is a list of the NCB fields and the 
description of each field. See the following figure for 
the correct format of the fields. 

Note: An "@" is used to represent the word 
"address" in the following list of descriptions. 


Network Control Block (NCB) Format 


Field Name 

Coding and Meaning 

NCB_COMMAND 

DB OOH 

NCB command 
field 

NCB_RETCODE 

DB OOH 

NCB return code 
field 

NCB_LSN 

DB OOH 

NCB local session 
number field 

NCB_NUM 

DB OOH 

NCB number of 
your name 

NCB_BUFFER@ 

DD OOOOOOOOH 

NCB pointer to 
message buffer 
address 

(offset :segment) 

NCB__LENGTH 

DW OOOOH 

NCB buffer length 
(in bytes) 

NCB_CALLNAME 

DB 16DUP(0) 

NCB name on local 
or remote adapter. 

For CHAIN SEND, 
the first 2 bytes 
indicates length 
of second buffer. 

The next 4 bytes 
indicates the second 
buffer address. 


Figure 2-2 (Part 1 of 2). Network Control Block Format 
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Field Name 

Coding and Meaning 

NCB_NAME 

DB 16 DUP(O) ; isjQB name on local 

; adapter. 

NCB_RTO 

DB OOH ; |\|CB receive timeout 

; value 

NCB_STO 

DB OOH ; l\jQB send timeout 

; value 

NCB_POST@ 

DD OOOOOOOOH ■ NCB pointer to post 

; routine 

; (offset :segment) 

NCB_LANA_ 

NUM 

DB OOH ; NCB adapter number 

; for first adapter. 

; Use 01 H for second 
; adapter. 

NCB_CMD_ 

CPLT 

DB OOH . NCB command 

; status field 

NCB RESERVE 

DB 14DUP(0) ; NCB reserved area 


Figure 2-2 (Part 2 of 2) Network Control Block Format 


NCB_COMMAND 

A 1-byte field for the command code to execute. Each 
command can be executed in either a wait or no-wait 
mode. If the high order bit is set to 1 , the no-wait 
option is selected. If the high order bit is is set to 0, the 
wait option is selected. The remaining 7 bits are used 
to specify the command that you want the adapter to 
execute. 

For maximum throughput between the IBM PC 
Network Adapter and the Personal computer, the 
no- wait option is preferable. In addition, the no-wait 
option allows multiple commands to be queued for 
execution within the adapter. 

The programming interface to the IBM PC Network 
Adapter BIOS is different depending upon the selection 
of the wait/no-wait option. For example; when issuing 
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the instruction INT 5CH using the wait option, control 
is not returned to the next instruction until the adapter 
completes the command. When the command does 
complete, check either the AL register or the 

NCB RETCODE field for the status of the completed 

command. 

If you choose the no-wait option for the INT 5CH 
instruction, you will receive 2 return codes. One code 
is returned immediately after you issue the instruction. 
The following is a list of the possible return codes that 
can be found in the AL register: 


Immediate Return Codes 

• OOH — Good return 

• OSH — Invalid command 

• 21H — Interface busy 

• 22H — Too many commands outstanding 

• 23H — Invalid number in NCB LANA NUM field 

• 24H — Command completed while cancel occurring 

• 26H — Command not valid to cancel 

• 4XH — Unusual network condition 

• (50-FE)H — Adapter malfunction 

If the immediate return code is OOH, a final return code 
is posted to the user when the adapter has executed the 
command. The posting of the return eode can be done 
by having the adapter interrupt the user appUcation 
program or by the user application program checking 
the NCB_CMD_CPLT field. If the NCB_POST@ 
field is non-zero, the adapter interrupts the user 
application program at the address specified in the 
NCB_POST@ field. If the NCB_POST@ field is 
zero, the adapter does not interrupt the program and 
command completion must be determined by checking 
the NCB_CMD_CPLT field. 

When the adapter interrupts the user application 
program upon command completion, the final return 
code can be obtained from either the AL register or the 
NCB_RETCODE field. If checking the 
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NCB CMD CPLT field, a change in value from 

FFH (pending status) indicates command completion. 
This value represents the final return code. The final 
return code varies from command to command. 

If the immediate return code is other than OOH, the 
adapter cannot execute the requested command and 
adapter processing terminates. See “Error Recovery” 
on page 2-90 for the definitions and the recommended 
actions for each return code. 


NCB_RETCODE 

A 1 -byte field indicating the return code of a command. 
If the return code is OOH, the operation was successful. 
Any other number means that the operation failed or 
has not completed. If the no-wait option is used 
without being interrupted on command completion, the 
NCB_CMD_CPLT field not the NCB_RETCODE 
field contains the final return code. When a command 
has not completed, the return code is FFH. See section 
“Error Recovery” on page 2-90 in this chapter for the 
definitions and the recommended actions for each 
return code. 

When a command is completed, your routine is 
interrupted by the adapter at the post address. You can 
choose to check the AL register instead of the return 
code field. 

Never go into a program loop on the 

NCB RETCODE field looking for a command to 

complete. Loop on the NCB CMD CPLT field for 

this purpose. 


NCB__LSN 

A 1-byte field indicating the local session number. This 
is the number of the session you have with another 
name on the network. This is only valid after a CALL 
or LISTEN command has successfully completed. For 


2-18 Software Description 



SEND and RECEIVE commands under session 
support, this field must always be correctly filled in. 
For datagram support, the ESN does not apply. 

The NCB ESN field is assigned a number in a 

round-robin Modulo 254 technique ranging from 1 to 
254. OOH and FFH are never returned. 

The RESET co m mand uses this field to indicate the 
maximum number of sessions supported. 


NCB__NUM 

A 1-byte field indicating the number returned to you 
after an ADD NAME, ADD GROUP NAME 
command is executed. This number, not the name, 
must be used with all datagram support commands and 
and for RECEIVE ANY commands. 

The NCB NUM field is assigned a number in a 

round-robin Modulo 255 technique ranging from 2 to 
254. The permanent node name number is always 1. 
OOH and FFH are never retuned. 

The RESET command uses this field to indicate the 
maximum number of command blocks to be supported. 


NCB_BUFFER@ 

Note: An "@" is used to represent the word 
"address" in the following list of descriptions. 

A 4-byte field indicating a pointer to the buffer you 
wish to use with a command. This field is in Define 
Double-Word format (offsetisegment) and must be a 
valid address in memory. See the IBM Macro 
Assembler manual for references to define double-word 
format (DD). 
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NCB_LENGTH 

A 2-byte field indicating the length, in bytes, of the 
data you want transferred. 

For a RECEIVE, RECEIVE ANY, ADAPTER 
STATUS, SESSION STATUS, RECEIVE 
BROADCAST DATAGRAM, and RECEIVE 
DATAGRAM command, this field is used and updated 
to indicate the number of bytes that are actually 
received. For a SEND, CHAIN SEND, SEND 
DATAGRAM, and SEND BROADCAST 
DATAGRAM command, this field is used to indicate 
the number of bytes to be sent. 


NCB_CALLNAME 

A 16-byte field indicating the name with whom you 
want to communicate. All 16 bytes are used. The 
name can be either on your adapter or any other 
adapter. 

For a CHAIN SEND command, the first 6 bytes are 
used to specify the second buffer. In these 6 b 5 des, the 
first 2 bytes specify the length and the last 4 bytes 
specify the buffer address. These are specified in the 

same format as the NCB LENGTH and 

NCB BUFFER@ fields. The remaining bytes in this 

field are reserved. 


NCB__NAME 

A 16-byte field indicating the name that you are known 
by on the network. All 16 bytes must always be used. 
The table on the adapter can hold up to 16 names. You 
are always known by the permanent node name on the 
network. The permanent node name is 10 bytes of 
binary zeros, followed by 6 bytes returned by the 
ADAPTER STATUS command. 
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NCB RTO 


A 1-byte field used by the CALL and LISTEN 
commands to specify a time-out period for all 
RECEIVES associated with that session. The receive 
time-out is the maximum amount of time allowed 
before a RECEIVE command returns a time-out error. 
The time-out value is specified in increments of 500 ms. 
If binary zero (OOH) are specified, the default is no 
time out. The time-outs can also be different for each 
session, but are fixed once the session is established. 


NCB__STO 

l-byte field used by the CALL and LISTEN commands 
to signify a send time-out. The send time-out is the 
maximum amount of time allowed before a SEND 
command returns a time-out error. The time-out is 
specified in increments of 500 ms. SEND time-outs 
should be used with caution because they will always 
drop the session if they expire. If binary zero (OOH) 
are specified, the default value is no time-out. 


NCB_POST@ 

A 4-byte field indicating the address of the routine that 
is to be executed when the adapter has completed 
processing a command. This field is used in no-wait 
options only. This field is in Define Double-Word 
format (offset: segment) and must be a vaUd address in 
memory. Your post routine must establish DS and any 
other registers you need. Only AL, CS, ES, and BX 
registers are set for the NCB being completed. The 
post routine is called by the adapter interrupt level with 
interrupts masked. To return, issue an IRET. Your 
post routine should be short and return immediately, 
unless you unmask interrupts. 

If the post address is specified as all binary zero, a post 
does not occur. This allows a program to do other work 
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and then loop waiting for the NCB CMP CPLT 

field to see when it changes from FFH. When the 
change from FFH occurs, either the command 
completed or an error code is returned. Do not check 
the NCB RETCODE because it will change before 
the command is actually complete. This can be useful 
in a BASIC program by using PEEK and POKE. 


NCB_LANA__NUM 

A 1-byte field indicating which adapter you want to 
use. A value of OOH directs the command block to the 
first IBM PC Network adapter. A value of OlH directs 
the command block to the second IBM PC Network 
adapter. 


NCB_CMD__CPLT 

A 1 -byte field indicating the command status. A value 
of OFFH in this field indicates the command is pending. 
A value of OOH means that the command is complete. 
Any other value means that the command completed 
with an error. See section “Error Recovery” on page 
2-90 for a complete description of the error codes. 

This byte is only useful if the NCB POST@ was 

specified as all zero’s and you are using a no-wait 
option command. Otherwise, check the 
NCB RETCODE field. 


NCB__RESERVE 

A 14-byte reserved field. This space should be 
allocated because the BIOS uses this field to store 
temporary variables. 
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NCB Commands 


NCB commands control the adapter on the network. 
The commands are divided into four categories: 

• General 

• Name support 

• Session support 

• Datagram support 

Within each category, all of the commands, except for 
the RESET and CANCEL commands, are further 
divided into wait and no-wait options. The wait option 
means that when you issue the eommand, the processor 
waits until the command is completed before returning 
to the next instruction. The no-wait option means that 
the processor returns immediately after processing the 
command and is interrupted at the post address when 
the command is completed. 

You must fill in either all required parameters or use the 
default values for some of the commands in the 
Network Control Block (NCB). Command codes and 
return codes are represented by hexadecimal values. 


Wait Option 

When you use the wait option, check either the 

NCB RETCODE field or the AL register for the 

return code. See Appendix E for multitasking 
considerations. 


No-Wait Option 

When using the no-wait option, the issued command 
returns to the next instruction after the INT 5C. The 
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AL register should be checked for a good return code 
OOH. Refer to the description of each command issued 
for any other values returned. 

If the command was accepted with AL = OOH, an 
interrupt will occur when the command is completed. 

Either the AL register or the NCB RETCODE may 

be checked for the return value. If the command is 

accepted but not complete, the NCB RETCODE 

field should contain a FFH. 

Your program should handle one special case of the 
no-wait option. The no-wait post is on an interrupt 
level with interrupts masked. It is possible to get the 
command complete interrupt before your main routine 
has finished processing the accepted command. 

Be sure to specify each NCB COMMAND field 

correctly or you will receive a 03H return code. 
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General Commands 

General commands are used to enable your adapter on 
the network, to read status, or to control other 
outstanding commands. 


RESET 

Reset local adapter status and clear the name and 
session tables. This command allows you to change the 
number of sessions and NCB command blocks 
supported by the adapter. You can specify a value from 
1 to 32 for sessions and a value from 1 to 32 for NCB 
command blocks. At power-on time, the default values 
are 6 sessions and 12 commands. Session and NCB 
command blocks take space away from the data buffers 
on the adapter and reduce the packet size on the 
network. For best performance, only configure the 
number of sessions and commands that you actually 
need. If the specified values exceed the limits, the 
maximum values are used. If binary zeros are specified, 
the default values are used. 

Once a RESET is completed, the ADAPTER STATUS 
command can be used to see the resulting maximum 
data packet size allowed by the adapter. Since overall 
performance is related to the number of packets sent on 
the network, you can choose to optimize your message 
size to fit into one packet. If two adapters are reset to 
different command and session sizes, the resulting 
packet sent on the network will always be the smaller of 
the two. 

This command does not reset traffic and error statistics. 
Only a power-on reset will reset these statistics. 

Cmd code 32H — Wait for the command 

to be completed. 

Fields Required NCB ESN (Number of 

sessions to be supported.) 
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NCB_NUM (Number of 
command blocks to be 
supported.) 

NCB_LANA_NUM 
(Number of the adapter you 
want to reset.) 

Field Returned NCB_RETCODE 

Return Codes: 

Final Return Codes 

OOH — Good return 

OSH — Invalid command 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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CANCEL 


This command requests that the command, whose NCB 
can be found at the address given by 
NCB BUFFER@, be canceled. 

Commands that are not valid to CANCEL are; ADD 
NAME, ADD GROUP NAME, DELETE NAME, 
SEND DATAGRAM, SEND BROADCAST 
DATAGRAM, SESSION STATUS, RESET, and 
CANCEL. Use caution when canceling a SEND 
command because completing it will always drop the 
session. 

Cmd Code 35H — Wait for the command 

to be completed. 

Fields Required NCB LANA NUM 

(Number of the adapter you 
want to cancel.) 
NCB_BUFFER@ (Address 
of the NCB you want 
canceled.) 

Field Returned NCB RETCODE 
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Return Codes; 


Final Return Codes 

OOH — Good return 

03H — Invalid command 

23H — Invalid number in NCB LANA NUM field 

24H — Command completed while cancel occurring 

26H — Command not valid to cancel 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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ADAPTER STATUS 


Receive adapter status. This command gives the status 
information for a local or remote adapter by specifying 

the name in the NCB CALLNAME field. If an * is 

specified in the first byte of the NCB CALLNAME 

field, the information for the local adapter is returned. 
This information is placed in the specified buffer 

address, NCB BUFFER@, and the length field is 

updated to indicate the number of bytes of information 
received. 


The minimum number of bytes in the status buffer is 60 
bytes. The maximum number of bytes required to hold 
the status buffer is 348 bytes when 16 names are in use. 
In general, 60 + 18(X) = the number of bytes that are 
required, where X is the number of names in use. 

Note: A return code of 06H is posted in the 

NCB RETCODE field if the receive buffer is not 

large enough for the data. The remaining data is 
lost at this point. 


Cmd code 


Fields Required 


Field Returned 


33H — Wait for the command 
to be completed. 

B3H — Return immediately and 
post when the command is 
completed. 

NCB_BUFFER(a) 
NCB_LENGTH 
NCB_CALLNAME (local, 
remote, or an * for local) 
NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
status.) 

NCB RETCODE 


Data that is returned in the data buffer field contains 
the following information. 
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* Unit identification number — 6 bytes 

This number is part of the permanent node name. The 
unit identification number is represented as follows; 

Byte 0; Low word, low byte 
Byte 1 : Low word, high byte 
Byte 2: Middle word, low byte 
Byte 3 : Middle word, high byte 
Byte 4: High word, low byte 
Byte 5: High word, high byte 


* External jumper status — 1 byte 

The status of the external jumpers are represented as 
follows: 


7 

6 

5 

4 

3 

2 

1 

0 

W2 

W1 

X 

X 

X 

X 

X 

X 


Where: 

X = Reserved 


W2 = 1 Jumper W2 on adapter 
W2 = 0 Jumper W2 off adapter 

W1 = 1 Jumper W1 on adapter 
W1 = 0 Jumper W1 off adapter 


Figure 2-3 Jumper Status Byte 

* Results of last self-test — 1 byte 

See “Power-On Self-Tests (POST)” on page 3-63 for a 
description of the tests. 


2-30 Software Description 




* Software version — 2 bytes 

The software version of the protocol layers are 
represented as follows: 

ByteO: Major version number 
Bytel : Minor version number 


* Traffic and error statistics — 48 bytes 

1 . Duration of reporting period (in minutes) — 2 bytes 
After the counter reaches a value of OFFFFH, it 
will roll over to 0. 

2. Quantity of CRC errors received — 2 bytes After 
the counter reaches a value of OFFFFH, they will 
not increment further. i 

3. Quantity of alignment errors received — 2 bytes 
After the counter reaches a value of OFFFFH, they 
will not increment further.^ 

4. Quantity of collisions encountered — 2 bytes 
After the counter reaches a value of OFFFFH, it 
will roll over to 0. 

5. Quantity of aborted transmissions — 2 bytes A 
transmission can be aborted due to excessive 
collisions or for some other cause. i After the 
counter reaches a value of OFFFFH, it will roll 
over to 0. 

6. Number of successfully transmitted packets — 4 
bytes After the counter reaches a value of 
OFFFFFFFFH, it will roll over to 0. 


1 This is supplied by the Intel 82586 chip. See the Intel 82586 
Reference Manual, "System Control Block" section for further 
information. 
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7. Number of successfully received packets — 4 bytes 
After the counter reaches a value of 
OFFFFFFFFH, it will roll over to 0. 

8. Number of retransmissions — 2 bytes After the 
counter reaches a value of OFFFFH, it will roll 
over to 0. 

9. Number of times the receiver exhausted its 
resources — 2 b3des After the counters reach a 
value of OFFFFH, they do not increment further. i 


* Adapter resource statistics 

1 . Reserved for internal use — 8 bytes 

2. Free command blocks — 2 bytes 

3. Configured maximum NCBs — 2 bytes 

4. Maximum number of command blocks free 
command blocks — 2 bytes 

5. Reserved for internal use — 4 bytes 

6. Pending sessions — 2 bytes A pending session is 
either a CALL-pending, a LISTEN-pending, a 
session established, session aborted, HANG 
UP-pending, or HANG UP (complete). 

7. Configured maximum pending sessions — 2 bytes 

8. Total maximum of possible sessions — 2 bytes 

9. Maximum session data packet size — 2 bytes 


* Quantity of names in the local name table — 2 
bytes 
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• Local name table — 16 entries of 18 bytes each 

The first 16 bytes of each entry represent the name, 
and the last 2 bytes represent the name status. This 
first byte is equal to the name number. The second 
byte denotes the status when it is masked with an 87H. 
The mask is used to get the most significant bits and the 
last 3 bits of the byte. The other bits are reserved and 
can have nonzero values. 

• NXXXXOOO = Trying to register a name 

• NXXXXlOO = A registered name 

• NXXXXIOI = A de-registered name 

• NXXXXl 10 = A detected duplicate name 

• NXXXXl 1 1 = A detected duplicate name with 
de-register pending 

Where: 

- X = Reserved bit 

- N = 0 The name is a unique name 

- N = 1 The name is a group name 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 
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(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
OSH — Invalid command 
OlH — Illegal buffer length 
OSH — Command timed out 
06H — Message incomplete 
OBH — Command canceled 
19H — Name conflict detected 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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UNLINK 


This command is only used with the remote program 
load (RPL) feature. The command applies only if a call 
to IBMNETBOOT was made at power up time of this 
computer. The session with IBMNETBOOT is dropped 
when this command is issued. The BIOS also ends the 
INT 13 redirector to the network. For more 
information refer to the Remote Program Load section 
in this book. 

Cmd code 


Fields Required 


Field Returned 


Return Codes: 

Immediate Return Codes 

OOH — Good return 
OSH — Invalid command 
21H — Interface busy 

23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 


70H — Wait for the command 
to be completed. 

NCB_LANA_NUM 
(Number of the adapter you 
want to unlink.) 

NCB RETCODE 
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Final Return Codes 


OOH — Good return 

OSH — Invalid command 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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Name Support 

Name support commands allow your personal computer 
to be known by a name on the network. A name can be 
a unique name or a group name on the network. The 
adapter checks to see if a name is unique on an ADD 
NAME and returns an error if anyone else is using the 
name you want to add. When using an ADD GROUP 
NAME, the same name can be added by many adapters 
on the network. 

The adapter can have up to 16 names in the local name 
table. A permanent node name is always present and 
consists of 10 bytes of binary zero followed by the 
unique adapter unit ID number. This permanent node 
name is also unique on the network. You can find its 
value by issuing an ADAPTER STATUS NCB for a 
local status by putting an asterisk (*) in the callname 
field. Look at the first 6 bytes returned in the buffer 
specified. Append this number to 10 bytes of binary 
zeros to make a total of 16 bytes for the permanent 
node name. This permanent name does not show up as 
an entry in the local name table returned by the 
ADAPTER STATUS NCB command. 

The RESET command deletes all names from the 
specified adapter with the exception of the permanent 
node name. 

Reserved Names 

The following names are reserved and cannot be added 
or deleted: 

• Any name starting with an * in ASCII or OOH. 

• It is recommended that you should not use any 
name starting with IBM. 
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ADD NAME 


Add a 16-character name to the table of names. The 
name you add cannot be used by anyone else on the 
network. 

When the adapter processes this command, it sends a 
broadcast request on the network repeatedly. If no 
reply is received, the name is assumed to be unique and 
is added to the table of names. The command returns 

to you the number of your name in the NCB NUM 

field. This number is used in datagram support and for 
RECEIVE ANY commands. 

Cmd Code 30H — Wait for the command 

to be completed. 

BOH — Return immediately and 
post when the command is 
completed. 

Fields Required NCB NAME 

NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
add name.) 

Fields Returned NCB RETCODE 

NCB NUM 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 
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23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Final Return Codes 

OOH — Good return 

03H — Invalid command 

ODH — Duplicate name in local name table 

OEH — Name table is full 

15H — Name not found, cannot specify an * , 
or OOH 

16H — Name in use on remote adapter 

19H — Name conflict detected 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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ADD GROUP NAME 


Add a 16-character name to the table of names. The 
name you add cannot be used by anyone else on the 
network as a unique name but can be added by anyone 
as a group name. 

When the adapter processes this command, it sends a 
broadcast request on the network repeatedly. If no 
unique name replies, the name is added. The conunand 
returns to you the number of the name in the 

NCB NUM field. This number is used in datagram 

support and for RECEIVE ANY commands. 


Cmd Code 


Fields Required 


Fields Returned 


36H — Wait for the command 
to be completed. 

B6H — Return immediately and 
post when the command is 
completed. 

NCB_NAME 

NCB POST@ (If no-wait 

option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
add group name.) 

NCB_RETCODE 
NCB NUM 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 
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25H — Reserved name specified 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Final Return Codes 

OOH — Good return 

OSH — Invalid command 

ODH — Duplicate name in local name table 

OEH — Name table is full 

15H — Name not found, cannot specify an * , 
or OOH 

16H — Name in use on remote adapter 
21H — Interface busy 
22H — Too many commands outstanding 
25H — Reserved name specified 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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DELETE NAME 


Delete a 16-character name from the table of names 
kept in the adapter. You should use the HANG UP 
command before you delete the name. If the name has 
active sessions when this command is issued, the name 
is flagged as de-registered and the status, "command 
completed, name has active sessions" is returned to the 
user. The DELETE delays until all sessions associated 
with the name are closed or abnormally terminated. If 
the name has only pending non-active session 
commands when the DELETE NAME command is 
issued, the name is removed and the "command 
completed" status is returned to the user. The pending 
non-active session commands are terminated 
immediately with the "name was deleted" status. 
Non-active session commands are: LISTEN, RECEIVE 
ANY, DATAGRAM RECEIVE, RECEIVE 
BROADCAST DATAGRAM. 


A name flagged as de-registered continues to occupy an 
entry in the local name table until the de-registration is 
completed. 


Cmd Code 


Fields Required 


Field Returned 


31H — Wait for the command 
to be completed. 

BIH — Return immediately and 
post when the command is 
completed. 

NCB_NAME 
NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
delete name.) 

NCB RETCODE 


Return Codes: 
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Immediate Return Codes 


OOH — Good return 

03H — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H— Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Final Return Codes 

OOH — Good return 

03H — Invalid command 

OFH — Command completed, name has active 
sessions and is now de-registered 

15H — Name not found, cannot specify an * , 
or OOH 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note; The X can be any number. 
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Session Support 

Session support commands allow you to establish a 
logical connection (session) on the network, send and 
receive messages, end sessions, and read session status. 
More than one command can be outstanding because 
the connection is in two-way simultaneous transmission 
mode. 

Sessions are established between any two names on the 
network. These names can be on your adapter or any 
other adapter. Names are used to establish sessions, 
but a 1-byte number is used to refer to each session 
after they are established. This number is found in the 

NCB LSN field that is returned when a session is 

established. A maximum of 32 sessions are allowed. 
The same name pair can be used to establish more than 
one session. The difference between the session pairs 
are the different LSN fields. If you create a local 
session, two session entries are used instead of one. 

One side of the local session has a LSN number 
associated with it and the other side has a different 
LSN number. To establish a session with yourself, 
make the CALLNAME equal to the NAME field. 

Session support gives you reliable data transfer and 
receipt of a message. Messages can range from 
0 — 65,535 characters in length. The RESET command 
aborts all sessions. 
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CALL 


This command opens a session with another name 

specified by the NCB CALLNAME field using the 

local name specified by the supplied NCB NAME. 

The name that you call must have a LISTEN command 
outstanding for the session to be established. You can 
establish a session with either a local or a remote name. 
Multiple sessions can be established with the same pair 
of names. All SEND and RECEIVE commands for this 
session will abort if they are unsuccessful after the 
specified time-out intervals. The time-out intervals are 
specified in 500 millisecond units (a value of zero 
means that no time-out will occur). The CALL 
command will abort, if unsuccessful after the system 
time-out intervals. The system time-out intervals and 
retry count are constants in the adapter software. 

When the CALL is completed, a local session number 
(LSN) is assigned and used thereafter to refer to the 
established session. 

Local session numbers (NCB LSN) are assigned in a 

round-robin technique, starting from the next available 
value within the range of 1 to 254. 

Cmd Code lOH — Wait for the command 

to be completed. 

90H — Return immediately and 
post when the command is 
completed. 

Fields Required NCB_CALLNAME 

NCB_NAME 

NCB RTO (Specified in 500 

ms increments. If the field is 
set to OOH, no receive time-out 
occurs.) 

NCB STO (Specified in 500 

ms increments. If the field is 
set to OOH, no send time-out 
occurs.) 

NCB_POST@ (If no-wait 
option used) 
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NCB_LANA_NUM 
(Number of the adapter you 
want to call.) 

Fields Returned NCB_RETCODE 

NCB_LSN 

Return Codes: 

Immediate Return Codes 

OOH — Good return 

03H — Invalid command 

21H — Interface busy 

22H — Too many co mm ands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH— Unusual network condition 

(50-FE)H — Adapter malfunction 

Final Return Codes 
OOH — Good return 
03H — Invalid command 
OSH — Command timed-out 
09H — No resource available 
OBH — Command canceled 
1 IH — Local session table full 
12H — Session open rejected 
14H — Cannot find name called or no answer 
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15H — Name not found, cannot specify an * , 
or OOH 

18H — Session ended abnormally 

19H — Name conflict detected 

lAH — Incompatible remote device 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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LISTEN 


This command enables a session to be established with 

the name specified in the NCB CALLNAME field, 

using the name specified by the NCB NAME field. If 

the CALLNAME field has a name starting with an * , a 
session is established with any network node that issues 
a CALL to the local name. 

LISTEN for a specific name has priority over a 
LISTEN for any name. Sessions can be established 
with either a local or a remote name. Multiple sessions 
can be established with the same pair of names. 

All SEND and RECEIVE commands for this session 
abort if they are unsuccessful after the specified 
time-out intervals. If a SEND times-out, the session is 
abnormally terminated. 

The time-out intervals are specified in 500 millisecond 
units (a value of zero means that no time-out will 
occur). A LISTEN command does not time-out but, a 
LISTEN occupies a session entry and is considered a 
pending session in information returned on an adapter 
status command. Local session numbers (LSN) are 
assigned in a round-robin technique starting with the 
next available value within the range from 1 to 254. 
Also, if an * is used for the called name, the name that 
made the call will be returned in the CALLNAME 
field. 

The error "Name conflict detected" is returned if, 
during the completion of a LISTEN command, a unique 
name exists in more than one table. All nodes with the 
name registered, except for the one where the LISTEN 
command has returned successfully, will report the 
error "Name conflict detected". 

Cmd Code 1 IH — Wait for the command 

to be completed. Use this 
carefully because it does not 
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Fields Required 


Fields Returned 


time out and your program 
hangs until the command is 
satisfied. 

91H — Return immediately and 
post when the command is 
completed. 

NCB_CALLNAME (This 
can be specified in the first 
byte as an * . The * is used to 
listen for a call from anyone to 
your name. If a name is 
specified in this field, it takes 
priority over a name of * .) 
NCB_NAME 

NCB_RTO (Specified in 500 
ms increments. If the field is 
set to OOH, no receive time-out 
occurs.) 

NCB STO (Specified in 500 

ms increments. If the field is 
set to OOH, no send time-out 
occurs.) 

NCB POST@ (If no- wait 

option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to listen.) 

NCB_RETCODE 

NCB_LSN 

NCB_CALLNAME (If listen 
any used. Specified with an * .) 
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Return Codes: 


Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 

(50— FE)H — Adapter malfunction 

Final Return Codes 

OOH — Good return 

OSH — Invalid command 

09H — No resource available 

OBH — Command canceled 

1 IH — Local session table full 

15H — Name not found, cannot specify an * , 
or OOH 

17H — Name was deleted 
1 8H — Session ended abnormally 
19H — Name conflict detected 
lAH — Incompatible remote device 
21H — Interface busy 
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22H — Too many commands outstanding 
23H — Invalid number in NCB_LANA_NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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HANGUP 


This command closes the session with another name on 
the network indicated by the local session number. A 
"Good return" status is returned on a normal close and 
a "Session closed" status or an illegal local session 
number is returned if the session is already closed or 
never existed. 

When a HANG UP command is received, all pending 
local RECEIVE commands are terminated and returned 
to the issuer with "Session closed" in the 

NCB_ RETCODE field. The termination is valid 

regardless of whether or not any data had been 
transferred by the pending command. If a local SEND 
command is pending, the HANG UP commands delays 
until the SEND is completed or until approximately 20 
seconds have elapsed. This delay occurs whether or not 
the command has begun to transfer data or is waiting 
for the remote computer to issue a RECEIVE 
command. The HANG UP is performed if any of the 
following conditions occur: 

• The SEND is completed 

• The SEND has aborted 

• The SEND fails because the session was 
terminated by the other computer with a HANG 
UP. 

• The SEND fails because of the time-out specified 
when the session was opened. 

If one of the above conditions does not occur within 20 
seconds after the HANG UP command is executed, the 
HANG UP command is returned with a "Command 
timed-out" status and the session is aborted. 

When a session closes, all SEND and RECEIVE 
commands pending on the closed session are returned 
to the issuer with a "Session closed" status. Also, if a 
RECEIVE ANY command is pending on the local 
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name used by the session, it is returned to you with a 
"Session closed" status. Only a single RECEIVE ANY 
command is returned even though many RECEIVE 
ANY commands may be pending. Even though a single 
RECEIVE ANY command is returned, many SEND or 
RECEIVES can be returned when pending. 

When a session abnormally terminates, all outstanding 
commands on that session are returned to the issuer 
with a "Session ended abnormally" status. 


Cmd Code 


Fields Required 


Field Returned 


12H — Wait for the command 
to be completed. 

92H — Return immediately and 
post when the command is 
completed. 

NCB_LSN 

NCB_POST(a) (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to hang up.) 

NCB RETCODE 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 
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(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
OSH — Invalid command 
OSH — Command time-out 
OSH — Illegal local session number 
OAH— Session closed 
OBH- — Command canceled 
18H — Session ended abnormally 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB_LANA_NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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SEND 

This command sends data by the session number 
indicated in the local session number (LSN). The data 
is taken from the buffer indicated by the 

NCB BUFFER (g) for the indicated number of bytes. 

The buffer is limited to a size starting with 0 and up to 
65,535 bytes in length. 

When a session is closed by the remote computer, all 
SEND commands pending on the closed session are 
returned with a "Session closed" status. If a local 
HANG UP command is issued with any pending SEND 
commands, the HANG UP is delayed until the SEND 
commands are completed. 

If a session aborts, a "Session ended abnormally" status 
is returned. If the SEND time-out expires, the session 
is aborted and a "Command timed-out" status is 
returned. Time-out values for the SEND are associated 
with the session when a CALL or LISTEN was issued 
and cannot be specified here. 

If more than one SEND is pending, the data is 
transmitted in a first-in, first-out (FIFO) order within a 
session. 

If the SEND cannot complete for any reason, the 
session ends abnormally and the session is dropped. 

The reason for this is to guarantee data integrity. 

SEND commands without corresponding RECEIVES, 
consume resources on the adapter. It is not advisable 
to issue many SENDs without corresponding 
RECEIVES. 

Cmd Code 


Fields Required 


14H — Wait for the command 
to be completed. 

94H — Return immediately and 
post when the command is 
completed. 

NCB LSN 


Software Description 2-55 



NCB_BUFFER@ 

NCB_LENGTH 

NCB POST@ (If no-wait 

option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to send.) 

Field returned NCB RETCODE 


Return Codes: 

Immediate Return Codes 

OOH — Good return 
03H — Invalid command 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
03H — Invalid command 
OSH — Command timed-out 
OSH — Illegal local session number 
OAH — Session closed 
OBH — Command canceled 
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18H — Session ended abnormally 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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CHAIN SEND 


This command sends data by the session number 
indicated in the local session number (LSN). The data 
is taken from the buffers for the indicated number of 
bytes. Two buffers can be chained together with this 
command. 

The data in the second buffer is concatenated to the 
data in the first buffer and sent as a single message. 

The NCB CALLNAME is used to specify the length 

and address of the second buffer. The length must be 
specified in the first 2 bytes and the second buffer 
address is the next four bytes. 

When a session is closed by the remote computer, all 
CHAIN SEND commands pending on the closed 
session will be returned with a "Session closed" status. 
If a local HANG UP command is issued with any 
pending CHAIN SEND commands, the HANG UP is 
delayed until the SEND commands are completed. 

If a session abnormally terminates, a "Session ended 
abnormally" status is returned. If the CHAIN SEND 
time-out expires, the session is aborted and a 
"Command timed-out" status is returned. Timeout 
values for the SEND are associated with the session 
when a CALL or LISTEN is issued. 

Messages are limited to a size starting with 0 and up to 
65,535 bytes in length. 

If more than one CHAIN SEND is pending, the data is 
transmitted in a first-in, first-out (FIFO) order within a 
session. 

Cmd Code 17H — Wait for the command 

to be completed. 

97H — Return immediately and 
post when the command is 
completed. 

Fields Required NCB_LSN 


2-58 Software Description 



NCB_BUFFER@ 
NCB_LENGTH 
NCB_CALLNAME (The 
format for the second buffer is 
specified as follows:) 

1) NCB_LENGTH2 

DW OOOOH 

2) NCB_BUFFER2@ 

DD OOOOOOOOH 

NCB_POST(a) (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to chain send.) 

Field returned NCB RETCODE 


Return Codes: 

Immediate Return Codes 

OOH — Good return 
OSH — Invalid command 
21H — Interface busy 
22H — Too many commands outstanding 
23H— Invalid number in NCB_LANA_NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
OSH — Invalid command 
OSH — Command timed-out 
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OSH — Illegal local session number 

OAH — Session closed 

OBH — Command canceled 

18H — Session ended abnormally 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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RECEIVE 


Receive data from a specified session. If more than one 
RECEIVE command is outstanding, they are posted 
according to the following hierarchy; RECEIVE, 
RECEIVE ANY for a specified name, and RECEIVE 
ANY for any name. Once the commands are sorted 
according to hierarchy, all of the RECEIVE commands 
are processed in a first-in, first-out order. Time-out 
values for RECEIVE are specified during a CALL or 
LISTEN and cannot be specified here. 

When a session is closed, either by a local session close 
command or by the remote adapter closing the session, 
all pending NCBs for that session are returned with a 
session closed status. 

Note: A return code of 06H is posted in the 

NCB RETCODE field if the receive buffer is not 

large enough for the message being sent. You can 
issue another receive to obtain the rest of the 
information before a time-out occurs. 

Cmd Code 15H — Wait for the command 

to be completed. 

95H — Return immediately and 
post when the command is 
completed. 

Fields Required NCB LSN 

NCB_BUFFER@ 
NCB_LENGTH 
NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to receive.) 

Fields Returned NCB RETCODE 

NCB LENGTH 
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Return Codes: 


Immediate Return Codes 

OOH — Good return 
03H — Invalid command 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
03 H — Invalid command 
OSH — Command timed-out 
06H — Message incomplete 
OSH — Illegal local session number 
OAH — Session closed 
OBH — Command canceled 
18H — Session ended abnormally 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB_LANA_NUM field 
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4XH — Unusual network condition 


(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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RECEIVE ANY 


Receive data from anyone with whom you have a 
session. You must use your name number instead of 
your name when issuing this command. Your name 

number (NCB NUM) was returned when you issued 

the ADD NAME or ADD GROUP NAME command. 
If more than one RECEIVE command is outstanding, 
they are completed in a first-in, first-out (FIFO) order 
according to the following hierarchy: RECEIVE, 
RECEIVE ANY for a specified name, and RECEIVE 
ANY for any name. 

If a session is closed by the local or remote computer, 
or session aborted, one RECEIVE ANY or RECEIVE 
name will be posted with "session closed" or "session 
aborted" status regardless of the number of session 
receives that can be pending. If a RECEIVE ANY or 
RECEIVE name is pending, it is posted as "Session 
closed" with the ESN field posting the session that 
closed. A RECEIVE ANY with no name specified is 
posted only if no RECEIVE ANY name is pending for 
the session with that name. 

Note: A return code of 06H is posted in the 

NCB RETCODE field if the receive buffer is not 

large enough for the message being sent. You can 
issue another RECEIVE to obtain the rest of the 
information. 

Application programs should not use a RECEIVE 
ANY to any name because this command can 
receive messages from other programs running in 
the Personal Computer. 

Cmd Code 16H — Wait for the command 

to be completed. Use this 
carefully because it does not 
time-out. 

96H — Return immediately and 
post when the command is 
completed. 
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Fields Required NCB_BUFFER@ 

NCB_LENGTH 
NCB_NUM (If this field = 
FFH, then receive from any 
remote name, that you have a 
session with, for any of your 
names.) 

NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter you 
want to receive for any name.) 


Fields Returned NCB LSN 

NCB_RETCODE 
NCB_NUM (If FFH is 
specified.) 

NCB LENGTH 


Return Codes: 

Immediate Return Codes 

OOH — Good return 
OSH — Invalid command 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
OSH — Invalid command 


Software Description 2-65 



06H — Message incomplete 

OAH — Session closed 

OBH — Command canceled 

13H — Illegal name number 

17H — Name deleted 

1 8H — Session ended abnormally 

19H — Name conflict detected 

21 H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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SESSION STATUS 


Receive status of all active sessions for your name. 

This command optionally gives the status for all of the 
names in the local name table if an * is specified in the 

first byte of the NCB NAME field. The minimum 

buffer length possible is 4 bytes. 

Note: A return code of 06H is posted in the 

NCB RETCODE field if the receive buffer is not 

large enough for the data being sent. The 
remaining data is lost at this point. 


Cmd Code 


Fields Required 


Fields Returned 


34H — Wait for the command 
to be completed. 

B4H — Return immediately and 
post when the command is 
completed. 

NCB_BUFFER@ 
NCB_LENGTH 
NCB_NAME (Specify an * 
for all names.) 

NCB_POST(a (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for 
session status.) 

NCB_RETCODE 
NCB LENGTH 


Data areas returned contain the following; 

1. Name number of sessions being reported — 1 byte 

2. Number of sessions with this name — 1 byte 

3 . Number of RECEIVE DATAGRAM and 
RECEIVE BROADCAST DATAGRAM 
commands outstanding — 1 byte 
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4. Number of RECEIVE ANY commands 
outstanding — 1 byte 

5. Information that is returned about a session — 36 
bytes for each session 

a. Local session number — 1 byte 

b. State of the session — 1 byte 
This byte is represented as follows: 


LISTEN pending OlH 

CALL pending 02H 

Session established 03 H 

HANG UP pending 04H 

HANG UP complete OSH 

Session Aborted 06H 


c. Local name — 16 bytes 

d. Remote name — 16 bytes 

e. Number of RECEIVE commands 
outstanding — 1 b5de 

f. Number of SEND and CHAIN SEND 
commands outstanding — 1 byte 


Return Codes: 

Immediate Return Codes 

O0H — Good return 

03H — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 
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4XH — Unusual network condition 


(50-FE)H — Adapter malfunction 

Final Return Codes 

OOH — Good return 

OSH — Invalid command 

OlH — Illegal buffer length 

06H — Message incomplete 

15H — Name not found, cannot specify an * , 
or OOH 

19H — Name conflict detected 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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Datagram Support 

Datagram support commands allow you to send a 
message to a name, a group name, or to broadcast a 
message to everyone. These commands also allow you 
to receive a datagram message from a name, a group 
name, or from anyone on the network. Datagram 
support differs from session support in several ways. 
The message is never acknowledged by the receiver’s 
adapter, so it is up to the sender and receiver to agree 
on their own network protocols. Messages are limited 
in size starting with 0, up to 512 bytes in length. If you 
specify more than 512 bytes for a RECEIVE 
DATAGRAM or RECEIVE BROADCAST you will 
only receive the maximum that is allowed for a SEND 
DATAGRAM or SEND BROADCAST. 

Datagrams are smaller than session SENDs and require 
additional protocol interaction for reliable data 
transmissions. For reliable transmissions, sessions 
should always be used. 
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SEND DATAGRAM 


Send datagram to a unique name or group name for 
receipt at a local node or remote node. 


Cmd Code 20H — Wait for the command 

to be completed. 

AOH — Return immediately 
and post when the command is 
completed. 


Fields Required NCB BUFFER(a) 

NCB_LENGTH 
NCB_NUM 
NCB_CALLNAME 
NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
send datagram.) 


Field Returned NCB RETCODE 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

03 H — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 
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Final Return Codes 


OOH — Good return 

03 H — Invalid command 

OlH — Illegal buffer length 

1 3H — Illegal name number 

19H — Name conflict detected 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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SEND BROADCAST DATAGRAM 


Send a message to everyone who has a RECEIVE 
BROADCAST DATAGRAM command outstanding. 

If the remote adapter does not have a RECEIVE 
BROADCAST DATAGRAM outstanding, it does not 
get the message. If a computer issues a SEND 
BROADCAST DATAGRAM and the computer has a 
RECEIVE BROADCAST DATAGRAM co mm and 
outstanding, the adapter receives its own message. If 
the adapter has several broadcast messages pending the 
next SEND BROADCAST command issued satisfies all 
RECEIVE BROADCAST commands. 


Cmd Code 


Fields Required 


Field Returned 


22H — Wait for the command 
to be completed. 

A2H — Return immediately 
and post when the command is 
completed. 

NCB_BUFFER@ 

NCB_LENGTH 

NCB_NUM 

NCB_POST@ (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
send broadcast datagram.) 

NCB RETCODE 


Return Codes: 

Immediate Return Codes 

OOH — Good return 

03 H — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 
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23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
OSH — Invalid command 
OlH — Illegal buffer length 
13H — Illegal name number 
19H — Name conflict detected 
21H — Interface busy 
22H — Too many commands outstanding 
23H — Invalid number in NCB_LANA_NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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RECEIVE DATAGRAM 


Receive a datagram message from any name or anyone 
on the network directed to you. There is no time-out 
associated with this command. If you do not have a 
RECEIVE DATAGRAM command outstanding at the 
time a SEND DATAGRAM is issued, you will lose 
data. 

This command does not receive a broadcast datagram 
but will receive a group name. 

Note: A return code of 06H is posted in the 

NCB RETCODE field if the receive buffer is not 

large enough for the data being sent. The 
remaining data is lost at this point. 

Cmd Code 21H — Wait for the command 

to be completed. Use with 
care since all processing halts 
until the datagram is received. 
AlH — Return immediately 
and post when the command is 
completed. 

Fields Required NCB_BUFFER@ 

NCB_LENGTH 
NCB_NUM (If this field = 
FFH, then receive a datagram 
from any other name for any 
of your names.) 
NCB_POST(a) (If no-wait 
option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
receive datagram.) 

Fields Returned NCB_RETCODE 

NCB_LENGTH 
NCB CALLNAME 
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Return Codes: 


Immediate Return Codes 

OOH — Good return 

OSH — Invalid command 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB_LANA_NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 
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Final Return Codes 


OOH — Good return 

OSH — Invalid command 

06H — Message incomplete 

OBH — Command canceled 

13H — Illegal name number 

17H — Name deleted 

19H — Name conflict detected 

21H — Interface busy 

22H — Too many commands outstanding 

23H — Invalid number in NCB LANA NUM field 

4XH — Unusual network condition 

(50-FE)H — Adapter malfunction 

Note: The X can be any number. 
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RECEIVE BROADCAST DATAGRAM 


Receive a message from anyone who issues a SEND 
BROADCAST DATAGRAM command. There is no 
time-out for this command. 

Note: A return code of 06H is posted in the 
NCB RETCODE field if the receive buffer is not 
large enough for the data being sent. The 
remainder of the data is lost. 

Cmd Code 23H — Wait for the command 

to be completed. Use with 
care since all processing halts 
until the datagram is received. 
A3 H— Return immediately 
and post when the command is 
completed. 

Fields Required NCB_BUFFER(a) 

NCB_LENGTH 

NCB_NUM 

NCB POST@ (If no-wait 

option used) 
NCB_LANA_NUM 
(Number of the adapter for the 
receive broadcast datagram.) 

Fields Returned NCB RETCODE 

NCB_LENGTH 
NCB CALLNAME 


Return Codes: 

Immediate Return Codes 

OOH — Good return 
03H — Invalid command 
21H — Interface busy 
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22H — Too many commands outstanding 
23H — Invalid number in NCB LANA NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Final Return Codes 
OOH — Good return 
03 H — Invalid command 
06H — Message incomplete 
OBH — Command canceled 
13H — Illegal name number 
17H — Name deleted 
19H — Name conflict detected 
21H — Interface busy 
22H — Too many commands outstanding 
23H— Invalid number in NCB_LANA_NUM field 
4XH — Unusual network condition 
(50-FE)H — Adapter malfunction 
Note: The X can be any number. 
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Remote Program Load for the IBM PC 
Network 


To remotely load an IBM Personal Computer on the 
IBM PC Network you must have a program written to 
service the Remote Program Load (RPL) request issued 
by the adapter and an IBM PC Network adapter that 
has jumper W1 removed. See “Configurable Hardware 
Options” on page 3-70 for a detailed description of the 
jumper settings. Included on the diskette are sample 
programs that can be used to service the remote 
program load request. See “Sample Programs” on page 
2-82 for a description of the sample programs. 

The BIOS on the IBM PC Network Adapter provides 
the capability to load a computer from the IBM PC 
Network. The IBM PC Network BIOS redirects the 
initial diskette read requests to the network if there are 
no other drives enabled and the RPL jumper on the 
adapter is removed. The boot request goes to a special 
IBM name on the network called IBMNETBOOT. The 
IBMNETBOOT name must be active and it must 
handle the RPL requests from remote IBM Personal 
Computers. This function does not depend on the 
operating system and can operate with any operating 
system that uses RPL during bootstrap. The only 
restriction is that the operating system must use only 
INT 1 3 requests and not try to use the diskette 
hardware directly. 


RPL Request Format 

If there are no drives ready on the Personal Computer 
and the RPL jumper is removed, the following requests 
are issued: 

1 . The BIOS issues a RESET command to allow the 
maximum number of sessions and commands. 
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2. A CALL to IBMNETBOOT is issued by the BIOS. 
If this step fails, the computer will come up in 
ROM BASIC. 

3. If the call to IBMNETBIOS succeeds, the BIOS 
sends an 11 -byte message to IBMNETBOOT with 
the following format; 


Start End 


AX 

CX 

DX 

ES 

BX 

Carry flag 


Figure 2-4 Boot Record Format 


Note: The BIOS intercepts and reformats all 
INT 13 requests to the system. When the 
reformatting is done, the above format is used 
to send the information to IBMNETBOOT. 

The BIOS will then issue a RECEIVE for an 1 1 -byte 
reply message. 

4. In order to issue the request on the network, the 
BIOS uses IK of RAM from the highest memory 
address. This IK memory location is assigned 
using the memory size word from the ROM BIOS 
data area during power-up. 

5. After the above steps are finished, every INT 13 
request is sent to IBMNETBOOT. If the request is 
a Read, a RECEIVE is issued for an 1 1-byte 
header plus the data. For a Write request, 

1 1 -bytes plus data are sent. 

6. The following INT 13 requests are not sent by the 
BIOS: 

• All format requests (diskette and fixed disk) 

• Read long (fixed disk) 
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7. The INT 13 redirection to the network can be 
turned off by using the UNLINK command. This 
will allow a program to use other forms of a drive 
redirection to the network. 


Sample Programs 

Two sets of sample programs are included on the 
diskette in this book. The first sample is a listing with a 
simple example of how to use the BIOS. The second 
set of programs is an example of a working network 
using the BIOS and the remote program load features 
of the adapter. 


Sample Program Set 1 

This example uses two files on the Network Sample 

Program diskette in the back of this book. Print out the 

files CALL.LST and LISTEN.LST with the DOS 

TYPE command and refer to the following description 

of the programs. 

To get started: 

• You do not need to issue a RESET command if the 
default parameters are acceptable. 

• Create an NCB with your name in the name field 
and issue an ADD NAME command. All other 
fields should be zero. 

. Call NETBIOS by issuing an INT 5C. 

To send data to someone using sessions: 

• Create a CALL NCB inserting binary zeros in all 
unused fields. 

. Issue INT 5C. 
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Check the return code in the AL register when the 
command is finished. 


• You can use the old CALL NCB, change the 
command to SEND and then fill in the correct 
fields. Wait or no-wait options can be used. 

• Point the NCB buffer address (offsetrsegment) to 
the data you wish to send. 

. Issue INT 5C 

• When you are finished sending data, issue a 
HANG UP command. 

To receive data, using the no-wait option, from someone 
who calls you: 

• Issue a LISTEN NCB using the no-wait option. 

• When someone calls you, the post address in the 
NCB is your starting address. You will be 
executing on an interrupt level with interrupts 
masked. 

• After you are called, issue a RECEIVE command 
to the name of the caller and obtain data. Either 
wait or no-wait options can be used. 

• A RECEIVE ANY command can also be used to 
obtain data from anyone you have a session with. 

To receive status about active sessions, adapter status, or 
errors: 

Issue either a session status or adapter status NCB 
request. 

To broadcast a message: 

Issue a SEND BROADCAST DATAGRAM command 
NCB 
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To Receive a Broadcast message: 

. Issue a RECEIVE BROADCAST NCB. 

• A RECEIVE BROADCAST command must be 
outstanding or the message is lost. 
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Sample Program Set 2 


This set of programs is an example of a working 
network using the remote program load (RPL) feature 
on the adapter. These programs are only intended to be 
examples and may not work in all environments or 
operating systems. The intent of this example is to 
allow a programmer to learn more about the network 
and the BIOS. 

Before you begin, the environment needs to be defined. 
The following lists is the equipment needed to perform 
the example network: 

• One Personal Computer with 1 28K, a fixed disk, 
and an IBM PC Network Adapter. This computer 
is used as a dedicated computer to serve the 
network. When this computer is properly 
configured, it is known on the network as the 
Server computer. 

• At least one Personal Computer with 64K and with 
an IBM PC Network Adapter. These computers 
can be any configuration. Also, each IBM PC 
Network Adapter must have jumper W1 removed 
to enable the RPL feature. See “Configurable 
Hardware Options” on page 3-70 for the location 
of the W1 jumper. 

• An IBM PC Network Translator Unit. 

• IBM PC Network cable. 

• DOS 3.0 diskettes. 

• Blank diskettes. 


Getting Started 

Once the network hardware is set up, the following 
steps will help you configure the software for the 
example: 
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1 . Start with the Server computer. Install the IBM 
PC Network Adapter in this computer. 

2. Using the DOS 3.0 Make Directory command 
(MD), create a directory called IMAGES in the 
root directory of the fixed disk. 

3. Use the DOS COPY command to copy the 
programs IMGUTIL.COM and RPLS.EXE from 
the sample program diskette to the IMAGES 
directory. 

4. At the C> prompt, format a diskette and copy the 
system onto it. Copy the programs MUSIC.BAS 
and BASIC.COM from the DOS 3.0 diskettes onto 
this diskette. 

5. Type CD \ IMAGES at the C> prompt. 

6. At the C> prompt, type IMGUTIL. This program 
creates an image of a diskette on the fixed disk. 

The entire diskette is copied, so be sure there is 
enough room on the fixed disk for the images you 
want to store. 

7. The image utility prompts you for the name you 
want the image to have. At this prompt, type 
MUSIC. Insert into drive A the diskette you 
created from the previous step. Now you have an 
image called MUSIC on the Server’s fixed disk. 
This image contains the directory of the diskette, 
including any programs, data, and free space that 
was on the diskette. 

8. After the program has copied the diskette to the 
Server computer’s fixed disk, type RPLS at the C> 
prompt. Now the Server computer is dedicated to 
serve each computer loading from the network. 

9. For the other computers in the network, install an 
IBM PC Network Adapter in each with jumper WI 
removed. See “Configurable Hardware Options’’ 
on page 3-70 for information about the jumpers. 
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10. Now switch one of the remote computers on the 
network ON. If the jumper W1 is removed, the 
computer will try to load in the following order: 

a. From the diskette 

b. From the fixed disk (if available) 

c. From the network 

d. From ROM BASIC 

1 1 . When operating correctly, the remote computer 
should display the word MUSIC at the top of the 
screen. If you created other images on the Server’s 
fixed disk, these images would also be displayed on 
the screen. These images are on the Server’s fixed 
disk and can be used as if the files were on your A: 
drive. For example, if one of the images displayed 
was called NETWORK, you could use the DOS 
DIR command and display the directory of that 
image. 

12. You should have the A> prompt on the bottom of 
the screen. Type DIR MUSIC at the A> prompt. 
You should see the contents of the image you just 
selected. 

If you want to copy more diskette images onto the 
Server’s fixed disk, repeat step 4 for each diskette you 
create. Each diskette must have DOS copied onto it in 
order for the program to work. The maximum number 
of images you can store on the Server’s fixed disk is 6. 

The above set of programs is an example of how the 
network uses the RPL feature, so these programs must 
be used with caution. You can have errors when two or 
more computers are trying to write to the same image at 
the same time because there is no protection built into 
the sample program. 
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Two Adapter Cards In the Same Personal 
Computer 

You can install two IBM PC Network adapters in the 
same Personal Computer. The second adapter must be 
set so the BIOS knows which adapter is the second 
adapter. Jumper positions are identified in Chapter 3, 
“Configurable Hardware Options” on page 3-70. 

Whenever you issue an NCB, the NCB LANA 

NUM field must be OOH to "talk" to the first adapter. 
See “NCB Field Description” on page 2-15 for a 

description of the NCB LANA NUM field. Use 

OlH to "talk" to the second adapter. 


Adapter Presence Test 

A test can be issued in software to check for a working 
adapter in a computer. The following is the method to 
check for an adapter. 


Test Method 

1. Check interrupt vector 5 C. 

2. If the location contains all binary zeros, an adapter 
is not present in the computer. 

3. If the location contains a value other than all 
binary zeros, issue either command 7FH or FFH. 

4. If a code of 03H is returned, the adapter is present. 

5. If a code other than 03H is returned, check the list 
below to see if the code returned is one of the 
following to make sure that the adapter is present. 
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a. OOH — Good return 

b. 23H— Invalid number in NCB_LANA_NUM field 

c. 4XH — Unusual network condition 

d. (50-FE)H — Adapter malfunction 

e. FFH — Command pending status 

Note: The X can be any number. 
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Error Recovery 


The following table lists the return codes and 
recommended actions. 


Hex 

Val 

Return Code 

Name 

Return Code 
Meaning 

Recommended 

Actions 

OOH 

Good return 

Command 

complete 

No action required. 

This is normal after 
each successful 
command. 

01 H 

Illegal buffer length 
for SEND 
DATAGRAM, 

SEND 

BROADCAST, 

ADAPTER 

STATUS, or 

SESSION 

STATUS. 

A SEND 

BROADCAST or 

SEND 

DATAGRAM 
cannot send more 
than 51 2 bytes. 

For ADAPTER and 
SESSION 

STATUS, the 
buffer length 
specified was less 
than the minimum 
required. 

Specify the correct 
size for the buffer 
and try again. 

03H 

Invalid command 

i 

The command 
code used was 
incorrect. 

Reissue the correct 
command code. 


Figure 2-5 (Part 1 of 7). Return Codes and Recommended 
Actions 


2-90 Software Description 





















Hex 

Return Code 

Return Code 

Recommended 

Val 

Name 

Meaning 

Actions 

OSH 

Command 

The return code 

DFora CALL, try 


timed-out 

field has following 

again later. 2)For an 



meanings; 1)For a 

ADAPTER STATUS, 



CALL or for 

make sure you are 



2)ADAPTER 

using a correct 



STATUS, the 

name. 3)For a 



system time-out 

SEND, the session 



period has elapsed. 

has been terminated 



3)For a SEND or 

abnormally. 



for 4)RECEIVE, the 

Establish another 



time-out period 

session and reissue 



specified for the 

aSEND. 4)Fora 



CALL or LISTEN 

RECEIVE, reissue 



has elapsed. 5)For 

the command. 5)For 



a HANG UP, the 

a HANG UP the 



time-out period 

session has been 



has expired for an 

terminated 



outstanding SEND 
to complete. 

abnormally. 

06H 

Message 

You received part 

You must reissue 


incomplete 

of a message 

another RECEIVE or 



because your 

RECEIVE ANY 



specified buffer 

command to get the 



length is not big 

rest of the message 



enough to receive 

before the remote 



the full message. 

computer times-out. 

For ADAPTER 

STATUS, SESSION 
STATUS, RECEIVE 
DATAGRAM, and 
RECEIVE 

BROADCAST 
DATAGRAM, the 
remaining data is 
lost. 


Figure 2-5 (Part 2 of 7). Return Codes and Recommended 
Actions 
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Hex 

Val 

Return Code 

Name 

Return Code 

IVleaning 

Recommended 

Actions 

OSH 

Illegal local session 
number 

The session 
number you 
specified is not one 
of the active 
sessions. 

Specify an active 
session number 
when you issue a 
command. 

OSH 

No resource 
available 

Not enough space 
available in the 
adapter for the 
session. 

Reissue the 
command at a later 
time. 

OAH 

Session closed 

The session has 
been closed from 
either the local or 
remote computer. 

No action is 
required. This is 
notification for a 
pending SEND or 
RECEIVE command 
that the session has 
been closed. For a 
HANG UP, the 
session was closed 
by the remote 
computer. 

OBH 

Command 

canceled 

Notification 
received that the 
command was 
canceled. If the 
command that was 
canceled was a 

SEND or a CHAIN 
SEND,the session 
is abnormally 
terminated. 

No action is 
required. 

ODH 

Duplicate name in 
local name table 

You tried to specify 
a name that Is 
already in the local 
name table. 

Specify another 
name. 

OEH 

1 

Name table full 

Up to 16 names 
have already been 
added. 

Wait until a delete 
name is issued so an 
entry will become 
available. 


Figure 2-5 (Part 3 of 7). Return Codes and Recommended 
Actions 
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Hex 

Val 

Return Code 

Name 

Return Code 

Meaning 

Recommended 

Actions 

OFH 

Command 
completed, name 
has active sessions 
and is now 
de-registered. 

The name to be 
deleted is active in 
a session now, but 
is de-registered. 

When the name is 
marked 

de-registered and 
has active 
sessions, it still 
occupies a slot in 
the table. Name is 
unusable. 

Close all sessions 
using this name for 
the DELETE 
command to 
complete. 

11H 

Local session table 
full 

There are no 
available entries in 
the session table. 

(The number of 
sessions for a table 
is user- specified.) 

1) Wait until a 
session has closed 
so an entry becomes 
available. 2) Refer to 
the RESET 
command to alter 
values. 

12H 

Session open 
rejected 

No LISTEN 
command is 
outstanding on the 
remote computer. 

Wait until a LISTEN 
is issued on the 
remote computer. 

13H 

Illegal name 
number 

Invalid name 
number. 

You must use the 
original name 
number that was 
assigned to the 
name. 

14H 

Cannot find name 
called or no answer 

The call name 
specified cannot be 
found or did not 

answer. 

Verify that the call 
name used is 
correct. Retry with 
the correct or a 
different call name 
or reissue if the 
remote computer is 
busy. 


Figure 2-5 (Part 4 of 7). Return Codes and Recommended 
Actions 
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Hex Return Code Return Code Recommended 

Val Name Meaning Actions 

15H Name not found. Either the name An asterisk or OOH in 

cannot specify * , you specified was column 1 is not 

or OOH. not in the table or allowed. Retry with 

you specified an another name and 

asterisk in column verify that it is the 
1 of the name field correct name, 
or you specified 

OOH. 

16H Name in use on Unique names can Specify another 

remote adapter. only be used once name. 

on the network. 

17H Name deleted This occurs when a No action required. 

name is deleted 
and there are no 
outstanding 
LISTEN, RECEIVE 
ANY, RECEIVE 
DATAGRAM, or 
RECEIVE 
BROADCAST 
DATAGRAM 
commands for that 

name. 

18H Session ended Either the remote 1) Check the remote 

abnormally computer is end for status and 

powered off, the check the cable, 

cable link is 2) For a SEND or 

broken, the session CHAIN SEND, or 

SEND or CHAIN RECEIVE or 

SEND has RECEIVE ANY, 

timed-out, or the reestablish the 

SEND or CHAIN session. 

SEND was 
canceled, or a 
HANG UP 
timed-out waiting 
for a SEND to 

complete. 

Figure 2-5 (Part 5 of 7). Return Codes and Recommended 
Actions 
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Hex 

Val 

Return Code 

Name 

Return Code 

Meaning 

Recommended 

Actions 

19H 

Name conflict 
detected 

Network protocol 
has detected two 
or more identical , 
names on the 

network. 

Everyone on the 
network should 
delete that name 
immediately. 

1AH 

Incompatible 
remote device 

Unexpected 
protocol packet 
received. 

Verify that all units 
on the network 
agree with the 
network protocols. 

21 H 

Interface busy 

You called the 

BIOS out of an 
interrupt handler 
routine in process. 

Return from the 
interrupt handler and 
try again later. 

22H 

Too many 

commands 

outstanding 

The maximum 
number of 
commands are 
outstanding. 

If not at maximum 
number, refer to 

RESET. If at 
maximum number, 
retry at a later time. 

23H 

Invalid number in 
NCB_LANA_ 

NUM field. 

You tried to specify 
a number other 
than OOH orOlH. 

Specify either OOH 
for the first adapter 
or 01 H if you have 
and want to use the 
second adapter. 

Correct the number 
and try again. 

24H 

Command 
completed while 
cancel occurring 

You tried to cancel 
a command that 
already completed, 
or never existed. 

No action required. 

26H 

Command not valid 
to cancel 

You tried to cancel 
a command that is 
invalid to cancel. 

See CANCEL 
command for the list 
of commands not 
valid to cancel. 


Figure 2-5 (Part 6 of 7). Return Codes and Recommended 
Actions 
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Hex 

Val 

Return Code 

Name 

Return Code 
Meaning 

Recommended 

Actions 

4XH 

Unusual network 
condition Note: 

The X can be any 

Hex value. 

The BIOS has 
detected an 
unusual condition 
in the network. 

Either retry or reset 
the command. If the 
error is displayed 
again, refer to your 

IBM Guide to 
Operations for the 
appropriate action. 

50- 

FEH 

Adapter 

malfunction 

The adapter has 
detected an 
internal problem. 

Retry the operation. 

If you receive the 
code again, contact 
your authorized 
dealer. 

FFH 

Command pending 
status 

The command is 
still pending. 

No action is 
required. See 

NCB POST® and 
NCB_ RETCODE 
for description of 
this return code. 


Figure 2-5 (Part 7 of 7) Return Codes and Recommended 
Actions 
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Introduction 


This chapter provides a description of each of the 
components that make up the IBM PC Network. The 
IBM PC Network Adapter connects a Personal 
Computer to a broadband local area network. The IBM 
PC Network Translator Unit is used by all of the 
Personal Computers to communicate with each other. 
The Translator Unit also has connection hardware for 
up to eight Personal Computers. Up to 72 nodes within 
a 1000 foot radius are supported by using the IBM 
Translator Unit and the IBM cable kits. 

The IBM PC Network Coaxial Cable system is also 
detailed in this chapter. 
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IBM PC Network Adapter 


The adapter plugs into one of the 1/ O slots within the 
Personal Computer. All required network signals and 
protocols are controlled by the adapter. 

The adapter has two major sections, Digital and RF 
Modem. The following block diagram shows how the 
internal data path is structured within the adapter. 
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Figure 3-1 Functional Block Diagram 
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Digital Section 

This section consists of the following components; 

• Intel 80188 microprocessor 

• Personal Computer / Host Interface Controller 
(HIC) 

• Intel 82586 Local Communications Controller 
(LCC) 

• Sytek Serial Interface Controller (SIC) 

. A 16Kx8of DataRAM 

• A 32K X 8 Adapter ROM 
. A 32 X 8 ID PROM 

. An 8K X 8 BIOS ROM 
(K = 1024 bytes) 

All components in this section are connected within the 
adapter by an 8-bit wide internal data bus except the 
8K X 8 BIOS ROM. The 8K x 8 ROM is directly 
accessed through the HIC. 


The 80188 Microprocessor 

The 80188 contains two independent direct memory 
access (DMA) channels, programmable timers, a 
programmable interrupt controller, and bus interface 
logic on a single integrated circuit. Additional 
information may be obtained in the publications listed 
in the bibliography. Communication between the 
Personal Computer and the adapter logic is 
accomplished through the Personal Computer / Host 
Interface Controller (HIC). 
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The microprocessor uses one of the two DMA channels 
to transfer data between the Personal Computer’s 
interface registers and the local buffer memory. The 
microprocessor accepts four external peripheral 
interrupt requests. Two of these interrupts come from 
the Personal Computer interface. Another interrupt 
comes from the Sytek Serial Interface Controller (SIC) 
and the other is from the Intel 82586 (LCC). The 
interrupt priority scheme is programihable, but is fixed 
by the adapter’s microcode. 

The 80188 provides three memory select signals to 
select three different ROM/RAM devices. Also, there 
are three peripheral select signals to select the local 
communication controller, the Personal Computer HIC, 
or the Sytek SIC. 


Personal Computer Interface Circuits 

The Personal Computer interface circuit comprises the 
HIC and several TTL bus transceivers and drivers. It 
allows the IBM PC Network Adapter to appear as an 
array of 1/ O address spaces in the Personal Computer. 
These circuits contain a set of interface registers and 
necessary control logic to transfer commands and data 
between the Personal Computer memory and the local 
buffer memory. 


RF Modem Interface Circuits 

The Sytek Serial Interface Controller (SIC) and the 
82586 (LCC) comprise the interface to the RF Modem 
portion of the IBM PC Network Adapter. Together, 
they interface data and commands from the parallel 
internal data bus to the serial network. They also 
implement the link layer protocols required by the 
network. Additional information on the 82586 can be 
obtained in the publications listed in the bibliography. 
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Adapter RAMs 


The IBM PC Network Adapter uses 16K x 8 of RAM 
as its buffer memory. This is dynamic RAM and the 
circuitry on the adapter does the refresh operation. The 
circuitry is controlled by a programmable timer in the 
80188. 

This memory is used for the IBM PC Network 
Adapter’s internal scratch memory, stacks, protocol 
control, and for buffering transient data to and from 
the Personal Computer interface registers. 


Adapter ROMs and PROM 

The BIOS ROM is located on the adapter in a single 
24-pin, 8K X 8 bit integrated circuit. It is an extension 
of the Personal Computer’s software for network 
support. It can be accessed by the Personal Computer 
and can be disabled by removing jumper W8 on the 
adapter. See “Configurable Hardware Options’’ on 
page 3-70 for a description of the jumper positions. 

The ROM has separate output control and enable 
control lines. Whenever an access is made to the 
adapter BIOS by the Personal Computer, this ROM is 
selected by the control lines. 

The 32K x 8 Adapter ROM contains program and 
protocol information for the 80188 microprocessor. 

The 32 X 8 ID PROM contains information about the 
adapter’s ID. This number is the network node address 
of the adapter and is unique for each adapter. The 
address is also referred to as the permanent node name. 


IBM PC Network Adapter Characteristics 

The following paragraphs describe the characteristics of 
the IBM PC Network Adapter. These characteristics 
also apply to many different types of Personal 
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Computers that can have an IBM PC Network Adapter 
installed. The following paragraphs refer to this as 
either a "host" or a "host computer", meaning any 
Personal Computer with an IBM PC Network Adapter 
installed. 


Data Transfer 

The fundamental software interface between a host’s 
processor and the IBM PC Network Adapter’s 
processor is provided by a set of interface registers in 
the HIC. One of the interface registers is the data 
register, a bidirectional, 2-byte FIFO register. The data 
register holds data to be transferred between a host and 
the IBM PC Network Adapter. The data register is 
readable and writable by both the host and the adapter. 
Specific operations being performed determine which 
processor reads and which processor writes. 

There are three basic methods to transfer data through 
the data register from host memory to adapter memory. 
Note that the transfer of data from adapter to host is 
analogous to the transfer of data in the opposite 
direction. Both the host processor and the adapter 
processor can choose to use any of these three methods 
independently. The three methods are; 

. Polled I/O 

• Interrupt 1/ O 

• DMA transfers 


DMA Operations 

For best performance, the primary method for 
transferring data between the host and adapter is 
accomplished by DMA operations. There are two 
separate DMA controllers that can access this interface. 
The host DMA controller is used for transferring data 
between host memory and the data register. The 
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two-channel DMA controller within the Intel 80188 is 
used in the adapter for transferring data between 
adapter memory and the 2-byte FIFO data register. 
The maximum transfer rate of the Intel 80188 
integrated DMA controller is 1.0 Mbytes per second. 


DMA Scheme 

The Personal Computer HIC provides two DMA 
requests, one to the IBM PC Network Adapter 
processor and one to the Personal Computer processor. 
The Personal Computer’s DMA controller is 
responsible for moving data and commands between 
the Personal Computer’s system memory and the 
adapter interface data register. When instructed, the 
80188’s DMA controller ntoves data and commands 
between the local buffer memory and the interface data 
register. 

To ensure reliable data transfer, handshake signals such 
as DMA REQUEST, DATA REGISTER FULL, and 
DATA REGISTER EMPTY are used to synchronize 
the data flow to and from both sides. 

Upon completion of a host DMA transfer, a DMA 
complete interrupt can be sent to the host processor 
through the adapter. 

The Intel 80188’s integrated DMA controller is 
controlled by the adapter processor. It accepts a 20-bit 
address, a 2-byte transfer length and an 1/ O address 
from the adapter processor. Also upon completion of 
DMA transfer, a DMA complete interrupt is sent to the 
adapter processor. 


Interrupt Structure 

Another method of communication between the host 
and the adapter is through vectored interrupts. These 
are asynchronous events, which cause a change in the 
flow of program control of the processor (either the 
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host or the adapter) being interrupted. Each processor 
can be interrupted both by events external to it, such as 
a request for service from the interface or by internal 
events such as the completion of an operation initiated 
by the same processor. 

A processor may, for various reasons, want to prevent 
interrupts from occurring. For example, interrupts 
usually are not allowed while a critical data structure or 
piece of status information is being updated. Also, a 
particular application program or operating system may 
not be equipped to deal with interrupts. For this 
reason, each processor has the ability, by the setting of 
certain bits in its interface registers, to enable and 
disable the various interrupts on an individual basis. 

There are six distinct types of interrupts that each 
processor may receive. These are discussed separately 
for the host and for the adapter. 


Host Interrupts 


1 . The first type of interrupt received by the host 
informs it that it has received control of the 
interface to the adapter and may place data in the 
Interface registers. 

The purpose of this interrupt is to free the host 
from having to wait for the adapter to yield control 
of the interface. The host processes some other 
task until the interface becomes free. Then the 
host is notified by the interrupt. Upon receipt of 
this interrupt, the host issues a command to the 
adapter and then relinquishes control of the 
interface. This interrupt occurs when the following 
three conditions are satisfied: 

a. The host has requested control of the interface 
by setting the Host Control Request (HCR) 
bit in the Host Interface register. 
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b. The adapter has allowed host control of the 
interface by setting the Host Control Enable 
(HCE) bit in the Adapter Interface register. 

c. The host has enabled this interrupt by setting 
the Host Control Interrupt Enable (HCI) bit 
in the Host Interface register. 

2. The second kind of interrupt the host can receive is 
caused by a request from the adapter for service or 
attention. This interrupt usually occurs as a result 
of the host’s having instructed the adapter to 
perform a function. While the adapter is executing 
a function, it requires support from the host. For 
example, if the host orders the adapter to send a 
message to another point on the network, the 
adapter must request that the host transfer the data 
to the adapter. This request is necessary because 
the adapter is not permitted to control the host’s 
data bus, and thus is unable to perform the transfer 
without the cooperation of the host. 

This interrupt to the host occurs when the adapter, 
after gaining control of the interface, sets the GO 
bit in the Status register. To receive the interrupt, 
the host must have enabled it by setting the Go 
Interrupt Enable (GI) bit in the Host Interface 
register. After servicing the adapter’s request, the 
host clears the GO bit, and then the adapter 
rehnquishes control of the interface. 

3. The third type of interrupt sent to the host is 
triggered by the same bit as the previous one. 

When the adapter, after executing a command 
issued by the host, clears the GO bit in the Status 
register, the host receives an interrupt. This 
interrupt is received only if the host has enabled it 
by setting the GI bit in the Host Interface register. 
Upon receipt of the interrupt, the host either issues 
another command to the adapter, or relinquishes 
control of the interface by clearing the Host 
Control Request (HCR) bit in the Host Interface 
register. 
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4. The next two types of interrupts seen by the host 
are related to the transfer of data between the 
adapter and the host. All such transfers take place 
through the Data register. 

When one processor writes data into the Data 
register, whether under control of the processor 
itself or of its DMA hardware, the interface 
hardware sets the Data Register Full (DRF) bit in 
the Status register. This informs the other 
processor that 1 or 2 bytes of data are available for 
reading. 

Similarly, when the Data register is read by the 
other processor, the hardware sets the Data 
Register Empty (DRE) bit in the Status register, 
indicating that one or two bytes of data may now 
be written to the Data register. 

Two bits in the Host Interface register control 
interrupts that are related to data transfer. The 
first of these is the Data Transfer Interrupt Enable 
(DTI) bit. Setting this bit causes an interrupt when 
the Data Register Empty or Full (DRE or DRF) 
bits are set depending on the setting of the second 
bit. 

The second bit is the Data Direction (DD) bit, 
which indicates the direction of data flow through 
the Data register. 

By setting the Data Transfer Interrupt Enable 
(DTI) and the Data Direction (DD) bit in the Host 
Interface register, the host can arrange to receive 
an interrupt every time a byte of data is written to 
the Data register by the adapter. Likewise, setting 
the DTI bit but clearing the DD bit causes the host 
to receive an interrupt each time a byte of data 
written to the Data register by the host is read by 
the adapter. Both the Data Register Full and the 
Data Register Empty (DRF and DRE) bits may be 
set at the same time; the two conditions are not 
mutually exclusive. 
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5. The final type of interrupt sent to the host is 
caused by the termination of a DMA operation 
between the host and the adapter. Such operations 
are to send command blocks from the host to the 
adapter, to return completed command blocks to 
the host, or to transfer message between the host 
and the adapter. If the host transfers data to and 
from the adapter through DMA operations (it does 
not need to do so), it has the option of receiving an 
interrupt upon completion of the operation. This 
can be done by setting both the Terminal Count 
Interrupt Enable (TCI) and the Data Transfer 
DMA Enable (DTD) bits in the Host Interface 
register. Whenever the DMA transfer mode is 
being used, the adapter interface detects the host 
signal indicating DMA completion on DMA 
channel 3 and sets the Terminal Count (TC) bit in 
the Status register. If the TCI bit is set, this will 
cause an interrupt to the host. 

The adapter can receive a set of interrupts similar to 
that seen by the host. These interrupts are described in 
the following paragraphs. 


Adapter Interrupts 


1. The first type of interrupt that can be sent to the 
adapter is analogous to the one received by the 
host when it has acquired control of the interface 
to the adapter. When the adapter requires control 
of the interface, it sets the Host Relinquish 
Interrupt Enable (HRI) bit in the Adapter 
Interface register. When the host yields the 
interface by clearing the Host Control Request 
(HCR) bit in the Host Interface register, an 
interrupt is sent to the adapter. The adapter 
should have previously cleared the Host Control 
Enable (HCE) bit in the Adapter Interface register 
so that once the host gives up control of the 
interface it is prevented from regaining it until the 
adapter finishes using the interface and again sets 
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the HCE bit. Like the corresponding host 
interrupt, this interrupt allows the adapter to 
continue other processing while waiting for control 
of the interface. 

2. The second kind of interrupt sent to the adapter 
results from the host’s sending the adapter a 
request for service or attention. These requests 
usually take the form of a command block 
constructed by the host’s application program. 

The adapter receives this interrupt, if it is enabled, 
when the host, after acquiring control of the 
interface, sets the GO bit in the Status register. 

The adapter enables the interrupt by setting the Go 
Interrupt Enable (GI) bit in the Adapter Interface 
register. After the adapter has received the 
interrupt and serviced the host’s request, it clears 
the GO bit; the host then gives up control of the 
interface. 

3. The third type of interrupt sent to the adapter is 
also triggered by the GO bit in the Status register. 
When the host, after executing a command issued 
by the adapter, clears the GO bit in the Status 
register, the adapter receives an interrupt. This 
interrupt is received only if the adapter has enabled 
it by setting the GI bit in the Adapter Interface 
register. Upon receipt of the interrupt, the adapter 
can elect either to issue another command to the 
host or to relinquish control of the interface by 
setting the HCE bit in the Adapter Interface 
register. 

4. The next two interrupts that the adapter can 
receive correspond to the host’s Data 
register-related interrupts. If the Data Transfer 
Interrupt (DTI) bit is set in the Adapter Interface 
register an interrupt is sent to the adapter each 
time the DRF or DRE bits are set in the Status 
register, depending upon the setting of the DD bit 
in the Adapter Interface register. 
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5. The last type of interrupt seen by the adapter is an 
internal one, not dependent on the host. When the 
adapter performs a DMA transfer to or from the 
host, it instructs its own DMA controller hardware 
as to the source and destination addresses, length 
of transfer and mode of operation. If instructed to 
do so, the DMA hardware sends an interrupt to the 
adapter when the transfer count has been 
decremented to zero. This completes the DMA 
operation. 


Summary 

As discussed above, each processor can receive six 

different types of interrupts related to the interaction 

between the host and the adapter. The following rules 

govern interrupts between host and adapter. 

• Each of these interrupts can be disabled by the 
host or adapter on an individual basis. 

• Each processor can receive an interrupt when it 
acquires control of the interface registers. 

• Each processor can be interrupted by a request 
from the other processor for service or attention, 
and the recipient is responsible for clearing the GO 
bit. 

• Each processor can receive an interrupt, when the 
other processor clears the GO bit, in response to 
the setting of the GO bit by the first processor. 

• Each processor can be informed when a new data 
byte is available in the Data register and when a 
byte it has written there has been read by the other 
processor. 

• Finally, each processor can receive an interrupt 
when its DMA hardware has completed a transfer. 
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Adapter Initialization 


The IBM PC Network Adapter executes initialization 
and self-test routines whenever it detects a hardware 
reset signal from the Personal Computer during 
power-up or when it detects that the software control 
reset bit in the Personal Computer HIC is set. The 
Personal Computer controls the reset and initialization 
of the IBM PC Network Adapter during system 
operations. The following is a description of what 
occurs during a software reset. 

The adapter is held in the reset state whenever the 
Reset Adapter (RES) bit in the Host Interface register 
is set. The Reset Adapter bit is set when the RESET 
DRV signal from the host is active. Setting this bit 
does not require that the host have control of the 
interface, because the reason for performing the reset 
may be to force an errant adapter to give up interface 
control. This capability must be used carefully. 

When the adapter is released from reset by clearing the 
reset bit, the following actions occur: 

1. A self-test is performed. 

2. All internal data structures and command queues 
are reinitialized. 

3. All names are deleted from the name table. 

4. All sessions are aborted. 

The adapter then sends an Adapter Initialization 
Complete primary command to the host. The host 
acknowledges the command by clearing the GO bit in 
the Adapter Interface register, allowing the host to gain 
control of the interface. 
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Programming Interface 

This section discusses the programming interface 
between the host computer and the adapter. This 
includes the interface protocol, primary and secondary 
commands, DMA considerations, interrupts, aliases, 
broadcasting, resetting the adapter, and aborting 
commands. 


Secondary Commands 

These commands are known as Network Control 
Blocks (NCBs). See Chapter 2 for a complete 
description of the NCBs. 


Interface Protocol 

This section describes the interface protocol between 
the adapter and the host computer’s BIOS (Basic Input 
Output System). It discusses the basic transactions 
between the adapter and the host and the steps required 
to conduct these transactions. Interrupts and interface 
registers are mentioned, but not described in detail. 
Detailed descriptions of these aspects are contained in 
later sections. 

There are three main transactions between the host and 
the adapter as follows: 

1 . The host sends a command block to the adapter. 

2. Adapter asks host to transfer message data. 

3. The adapter asks the host to accept an updated 
command block. 

These transactions are described in the following 
paragraphs. 
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Host Sends a Command Block to the Adapter 

Most of the communication between the host and the 
adapter is initiated by the host. The host requests the 
adapter to execute a particular command, such as 
opening a session. These commands are sent as 
command blocks to be interpreted by the adapter. The 
command blocks are sent using the following steps; 

1 . The host’s application program constructs a 
network command block (NCB) and invokes 
BIOS. This method of construction is specified in 
detail in Chapter 2 and is not described here. 

2. BIOS requests control of the adapter interface by 
setting the Host Control Request bit in the Host 
Interface register. If the Host Control Interrupt 
Enable bit in the Host Interface register is set, an 
interrupt is issued to the host when interface 
control is granted. 

3. After receiving control of the interface, BIOS 
writes the 1-byte primary command code followed 
by the address of the command block (32 bit 
address in DD format) and the length of the 
command block (2 bytes) to the Parameter 
register. The BIOS then sets the GO bit in the 
Status register. This issues the command by 
causing an interrupt, when enabled, to be sent to 
the adapter. 

4. BIOS sends the command block to the adapter 
through the Data register. This may be done by 
setting up a DMA transfer or through programmed 
1/ O (the host processor writes a byte at a time to 
the Data register), at the option of the host BIOS. 

If using programmed 1/ O, the host can also choose 
whether to receive an interrupt as each byte is read 
by the adapter. 

5. The adapter finds, either through an interrupt or by 
polling, that the GO bit is set. 


Hardware Description 3-21 



6. The adapter reads the information in the Parameter 
registers. 

7. The adapter obtains the command block, either 
through programmed 1/ O (with or without using 
interrupts) or through DMA. 

8. The adapter clears the GO bit and loads the 
primary command completion code in the Status 
register. 

9. The host finds, either through an interrupt or by 
polling, that the GO bit was cleared; the host then 
releases the interface by clearing the Host Control 
Request bit in the Host Interface register. This 
may cause an interrupt to the adapter, informing it 
that the interface is now available. 

10. The adapter queues the new command internally. 

If the queue is full, the adapter clears the Host 
Control Enable bit in the Adapter Interface 
register and sets the Set Command Queue Full 
(SQF) flag. This prevents the host from issuing 
any more commands until some commands have 
been processed. 


Adapter Asks Host To Transfer Message 
Data 

Most commands involve a transfer of message data 
either from the host to the adapter (for example, 
session send) or from the adapter to the host (for 
example, session receive). In either case, the adapter 
must ask the host to transfer the data, since the adapter 
cannot gain control of the host’s data bus. When the 
adapter wishes to transfer data between itself and the 
host, the following events occur: 

1 . The adapter gains control of the interface by 
clearing the Host Control Enable bit in the 
Adapter Interface register and waits for the Host 
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Control bit in the Status register to be cleared. If 
the adapter chooses, it receives an interrupt when 
interface control is granted. 

2. The adapter loads the command followed by the 
address of the data buffer and length of the 
transfer (previously obtained from the command 
block) into the Parameter register. It then sets the 
GO bit in the Status register. This issues the 
command by causing an interrupt, if enabled, to be 
sent to the host. 

3. The adapter starts its part of the data transfer 
through the Data register, either through 
programmed I/O (with or without interrupts) or 
through DMA. 

4. The host finds, either through an interrupt or by 
polling, that the GO bit is set. 

5. The host reads the information in the Parameter 
registers. 

6. The host performs the data transfer, either through 
programmed 1/ O (with or without interrupts) or 
through DMA. 

7. The host clears the GO bit and loads the primary 
command completion code in the Status register. 

8. The adapter finds, either through an interrupt or by 
polling, that the GO bit was cleared; the adapter 
then releases the interface by setting the Host 
Control Enable (HCE) bit in the Adapter 
Interface register. This can cause an interrupt to 
the host if it had previously requested control of 
the interface. 
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Adapter Asks Host To Accept Updated 
Command Block 

The final operation in completing a command is the 

transfer of the updated command block to the host. 

This is done with the following steps: 

1 . The adapter updates the command block with 
completion status and other information, 
depending on the particular command. 

2. The adapter gains control of the interface by 
clearing the Host Control Enable bit in the 
Adapter Interface register and waits for the Host 
Control bit in the Status register to be cleared. If 
the adapter wishes, it receives an interrupt when 
interface control is granted. 

3. The adapter writes the command code 43H 
followed by the address and length of the 
command block to the Parameter register; it then 
sets the GO bit in the Status register. This issues 
the command, causing an interrupt, if it is enabled, 
to be sent to the host. 

4. The adapter starts its part of the data transfer 
through the Data register, either through 
programmed 1/ O (with or without interrupts) or 
through DMA. 

5. The host finds, either through an interrupt or by 
polling, that the GO bit is set. 

6. The host reads the information in the Parameter 
register. 

7. The host transfers the command block to its 
memory, either through programmed 1/ O (with or 
without interrupts) or through DMA. 

8. The host clears the GO bit in the Status register. 
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9. The adapter finds, either through an interrupt or by 
polling, that the GO bit was cleared; the adapter 
then releases the interface by setting the Host 
Control Enable bit in the Adapter Interface 
register. This can cause an interrupt to the host if 
it has previously requested control of the interface, 
and has enabled this interrupt. 

10. The host BIOS returns the updated command 
block to the host application program. 


Interface Control 

There are four types of interface registers in the 
Personal Computer interface controller: 

• Status register 

• Parameter register 

• Data register 

• Host/ Adapter Interface register 

Each register has two addresses depending on the 
setting of jumpers W5, W6 and W7. See section 
“Configurable Hardware Options” on page 3-70 for a 
detailed description of the jumper positions. The 
Personal Computer I/O register addresses are as 
follows; 


Hardware Description 3-25 



Register name 

Low 

address 

range 

High 

address 

range 

Status register 

360H 

368H 

Parameter register 

361 H 

369 H 

Data register 

362H 

36AH 

Host/ Adapter Interface 
register 

363 H 

36BH 


Figure 3-2 Register Addresses 


The adapter interface registers are used to pass 
commands, parameters, and data between the host and 
the adapter. Both the host and adapter may desire to 
pass information through this interface. There is only 
one set of registers, so a mechanism to resolve conflicts 
over register use must be included in the interface. 
Determination of who is in control of the interface is 
made by examining the Host Control (HC) bit in the 
Status register. When this bit is set, the interface is 
under control of the host. When the HC bit is not set 
the interface is either under control of the adapter or is 
idle. 

When the adapter desires control of the interface, it 
clears the Host Control Enable (HCE) bit in the 
Adapter Interface register. Clearing the HCE bit 
inhibits the HC bit from being set. However, if the HC 
bit is already set the adapter must wait until the host 
has cleared the Host Control Request (HCR) bit, 
causing the HC bit to be cleared. When the HCE and 
HC bits are both cleared, the adapter is in control of 
the interface and can use the interface registers. When 
the adapter is finished with the interface, it sets the 
HCE bit in the Adapter Interface register. This allows 
the host to gain control of the interface. 

When the host desires control of the interface it sets the 
Host Control Request (HCR) bit in the Host Interface 
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register. If the HCE bit has been set by the adapter in 
the Adapter Interface register, the Host Control (HC) 
bit is immediately set in the Status register. If the HCE 
in the Adapter Interface register is not set, the HC bit is 
not set until the adapter sets the HCE bit. Once the 
HC bit has been set, the interface is considered to be 
under control of the host. When the host is finished 
with the interface it clears the HCR bit in the Host 
Interface register. This causes the Host Control (HC) 
bit to be cleared in the Status register. 

The following table gives the state of the interface for 
various combinations of the HCE, HCR, and HC bits. 


HC 

HCR 

HCE 

State 

0 

0 

1 

Idle 

0 

0 

0 

Adapter in control 

0 

1 

0 

Adapter in control, host waiting for control 

1 

1 

1 

Host in control 

1 

1 

0 

Host in control, adapter waiting for control 


Figure 3-3 Interface Control States 


Hardware Description 3-27 




























Data Transfer 

Bulk data transfers between the host and the adapter 
occur through the Data register. Each side of the 
interface can elect to transfer data through this register 
using DMA, interrupts, or polling. The Data Direction 
(DD), Data Transfer Interrupt (DTI), and Data 
Transfer DMA (DTD) bits in the interface registers are 
used to select the transfer mode independently for each 
side. The following table summarizes the use of these 
bits. 


DD 

DTI 

DTD 

Operation 

X 

0 

0 

Polled I/O 

0 

1 

0 

Host to adapter using interrupts 

1 

1 

0 

Adapter to host using interrupts 

0 

0 

1 

Host to adapter using DMA 

1 

0 

1 

Adapter to host using DMA 

X 

1 

1 

Illegal 


Figure 3-4 Interface Registers Transfer Control Bits 


In addition the Terminal Count Interrupt (TCI) bit in 
the Host Interface register can be set to interrupt the 
host when terminal count has been reached in the host 
DMA. 
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Status Register (SR) 

Addresses: 

Host: 360H or 368H 

Adapter: OOH 


MSB 

7 


LSB 

0 



Go 

Command Completion Code 
Command Queue Full 
Data Register Empty 
Data Register Full 
Terminal Count 
Host Control 


Figure 3-5 Status Register 


Go (GO) 

Indicates the command is now ready for execution. If 
the GI bit is set for a side, that side is interrupted 
whenever the other side sets or clears this bit. It is 
cleared by the side receiving the primary command 
when the command has been completed. This bit can 
be read and written to by both sides and is cleared upon 
a reset. 


Command Completion Code (CCO-CCl) 

Used to pass the primary command completion code. 
These bits are cleared when GO is set on command 
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initiation, and set to the appropriate value when the GO 
bit is cleared by the side receiving the command. The 
following completion codes are as follows; 

OOH - Primary command completed successfully. 

OlH - Invalid primary co m mand or parameter. 

02H - Unable to complete primary command. 

03 H - Reserved 

These bits can be read and written to by both sides and 
are cleared upon a reset. 


Command Queue Full (CQF) 

This bit is set as a result of setting the Set Command 
Queue Full (SQF) bit in the Adapter Interface register 
and indicates to the host that the adapter cannot accept 
any commands at this time. The bit is read-only for 
both sides, and is cleared upon a reset. 


Data Register Empty (DRE) 

This bit is set by the interface whenever a byte can be 
written to the data register. This bit can cause 
interrupts or DMA cycles to occur to the host or the 
adapter if the appropriate DTD, DTI, and DD bits are 
set as described in Figure 3-8 on page 3-34. This bit is 
always read-only and is set upon a reset. 


Data Register Full (DRF) 

This bit is set by the interface whenever a byte can be 
read from the data register. This bit can cause 
interrupts or DMA cycles to occur to the host or the 
adapter if the appropriate DTD, DTI, and DD bits are 
set as described in Figure 3-8 on page 3-34. This bit is 
always read-only and is cleared upon a reset. 
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Terminal Count (TC) 


This bit indicates that terminal eount has been reached 
on the host DMA channel while transferring data to or 
from the adapter. For this bit to be set the DTD bit 
must be set in the Host Interface register and the TC 
and DACK3 signals must be asserted on the host 
peripheral bus. If the TCI bit is set in the Host 
Interface register when this bit is set, an interrupt is 
sent to the host. This bit is cleared when the DTD bit is 
cleared in the Host Interface register. This bit is always 
read-only and is cleared upon a reset. 


Host Control (HC) 

This bit indicates that the host has control of the 
interface. The setting of this bit causes an interrupt to 
the host if the Host Control Interrupt (HCI) is set in 
the Host Interface register. The HC bit is cleared when 
the host clears the HCR bit in the Host Control 
Register. If the Host Relinquish Interrupt (HRI) bit is 
set in the the Adapter Interface register, the clearing of 
the HC bit causes an interrupt to be sent to the adapter. 
This bit is always read-only, and is cleared upon a reset. 
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Parameter Raster (PR) 

The Parameter register is a 7 -byte shift register used to 
pass primary commands and their parameters. Because 
this register operates as a true shift register and not as a 
first-in, first-out (FIFO), it is necessary that 7 bytes 
always be written when passing parameters. This 
register is read/ write by both sides but should only be 
written to by the side controlling the interface. 

Addresses: 

Host: 361Hor369H 

Adapter: 02H 

MSB LSB 

7 6 5 4 3 2 1 0 


Parameter Bits 0-7 


Figure 3-6 Parameter Register 
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Data Register (DR) 

The Data register is a 2-byte FIFO used to pass data 
between the host and the adapter. When data is 
available to be read from this register, the Data Register' 
Full (DRF) bit is set in the Status register. When data 
can be written to this register, the Data Register Empty 
(DRE) bit is set in the Status register. Because this 
register is double buffered, both of these bits can be set 
at the same time. The setting of these bits can cause 
interrupts and DMA cycles to occur depending on the 
setting of enable bits in the interface registers. This 
register is read/ write by both sides. Depending on the 
command being performed, a determination is made as 
to which processor should read or write this register. 

Addresses: 

Host: 362H or 3 6 AH 

Adapter: 04H 

MSB LSB 

7 6 5 4 3 2 1 0 


Data Bits 0-7 


Figure 3-7 Data Register 
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Host Interface Register (HIR) 


The Host Interface register is used by the host to 
control interrupt and DMA requests going to the host, 
to force the adapter to be reset, and to request control 
of the interface. This read/write register is only 
accessible by the host. Interrupts to the host occur on 
either IR02 or IRQ3, depending on the setting of 
jumpers W3 and W4 on the adapter. DMA requests 
occur on DR03 with acknowledgments on DACK3. 

Addresses: 

Host: 363H or 36BH 

Adapter: Inaccessible 


MSB lsb 

7 6 5 4 3 2 1 0 


HCI 

TCI 

DTD 

DTI 

DD 

RES 

HCR 





Go Interrupt Enable 

Host Control Request 

Reset Adapter 

Data Direction 

Data Transfer Interrupt 
Enable 

Data Transfer DMA Enable 

Terminal Count Interrupt 

Host Control Interrupt 
Enable 


Figure 3-8 Host Interface Register 


Go Interrupt Enable (GI) 

If this bit is set, an interrupt is sent to the host if the 
GO bit is set or cleared by the adapter. The interrupt 
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cleared by the host’s reading the Status register. This 
bit is cleared upon a reset. 


Host Control Request (HCR) 

This bit is set by the host when it wants to gain control 
of the interface. When host control is granted, the Host 
Control (HC) bit is set in the Status register. Clearing 
this bit clears the HC bit in the Status register. This bit 
is cleared upon a reset. 


Reset Adapter (RES) 

If this bit is set by the host, the adapter executes a 
hardware reset and is held in the dormant state until 
this bit is cleared by the host. This bit is set anytime 
the RESET DRV signal from the host channel interface 
becomes active. 


Data Direction (DD) 

This bit is set by the host to indicate the direction of 
data transfer between the host and adapter and works 
in conjunction with the DTI and DTD in controlling 
interrupts and DMA requests to the host. If this bit is 
set, data transfer is from the host to the adapter. If this 
bit is cleared, transfer is from the adapter to the host. 


Data Transfer Interrupt Enable (DTI) 

If this bit is set, an interrupt is sent to the host 
whenever the Data Register Empty (DRE) or Data 
Register Full (DRE) bit is set, depending on the setting 
of the Data Direction (DD) bit. If the appropriate 
DRE or DRE bit is already set when this bit is set, an 
immediate interrupt occurs. This interrupt is cleared by 
the host’s accessing the Data register or by clearing the 
DTI bit. This bit is cleared upon a reset. 
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Data Transfer DMA Enable (DTD) 

If this bit is set, a DMA request is sent to the host 
whenever the Data Register Empty (DRE) or Data 
Register Full (DRE) bit is set depending upon the 
setting of the Data Direction (DD) bit. If the 
appropriate DRE or DRE bit is already set when this 
bit is set, an immediate DMA request occurs. This 
DMA request is cleared by the DACK3 signal or 
clearing the DTD bit. This bit is cleared upon a reset. 


Terminal Count Interrupt (TCI) 

If this bit is set, an interrupt is sent to the host 
whenever the Terminal Count (TC) bit is set in the 
Status register. If the TC bit is already set when this bit 
is set, an immediate interrupt occurs. The interrupt is 
cleared by the host’s reading the Status register or 
clearing the TCI bit. This bit is cleared upon a reset. 


Host Control Interrupt Enable (HCl) 

If this bit is set, an interrupt is sent to the host 
whenever the Host Control (HC) bit is set in the Status 
register. If Host Control is already set, an immediate 
interrupt occurs. This interrupt is cleared by the host’s 
reading the Status register. This bit is cleared upon a 
reset. 
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Adapter Interface Register (AIR) 


The Adapter Interface register is used by the adapter to 
control interrupt and DMA requests going to the 
adapter, and to control acquisition of the interface by 
the host. The adapter can read/ write this register, but 
it is inaccessible from the host. 

Addresses: 

Host: Inaccessible 

Adapter: 06H 


MSB 

7 


LSB 

0 


HRI 

SQF 

DTD 

DTI 

DD 


HCE 





Go Interrupt Enable 

Host Control Enable 

Not Used 

Data Direction 

Data Transfer Interrupt 
Enable 

Data Transfer DMA Enable 

Set Command Queue Full 

Host Relinquish Interrupt 
Enable 


Figure 3-9 Adapter Interface Register 


Go Interrupt Enable (GI) 

If this bit is set, an interrupt is sent to the adapter if the 
GO bit is set or cleared by the host. The interrupt is 
cleared by the adapter’s reading the Status register. 

This bit is cleared upon a reset. 


Hardware Description 3-37 




Host Control Enable (HCE) 


This bit allows the adapter to control the granting of 
interface control to the host. The HC bit is not set in 
the Status register in response to a Host Control 
Request (HCR) unless this bit is set. If the HCR bit is 
already set in the Host Interface register when this bit is 
set, the HC bit is immediately set in the Status register. 
Clearing this bit does not cause the HC bit to be 
cleared if it has already been set, but prevents it from 
being set again after it is cleared. The adapter must 
clear this bit before using the interface to prevent a 
control conflict. This bit is cleared upon a reset. 


Data Direction (DD) 

This bit is set by the adapter to indicate the direction of 
data transfer between the host and adapter, and works 
in conjunction with the DTI and DTD in controlling 
interrupts and DMA requests to the adapter. If this bit 
is set, data transfer occurs from the host to the adapter. 
If this bit is cleared, transfer is from the adapter to the 
host. 


Data Transfer Interrupt Enable (DTI) 

If this bit is set, an interrupt is sent to the adapter 
whenever the Data Register Empty (DRE) or Data 
Register Full (DRF) bit is set, depending on the setting 
of the Data Direction (DD) bit. If the appropriate 
DRE, or DRF bit is already set when this bit is set, an 
immediate interrupt occurs. This interrupt is cleared by 
the adapter’s accessing the Data register or clearing the 
DTI bit. This bit is cleared upon a reset. 


Data Transfer DMA Enable (DTD) 

If this bit is set, a DMA request is sent to the adapter 
whenever the Data Register Empty (DRE) or Data 


3-38 Hardware Description 



Register Full (DRF) bit is set, depending on the setting 
of the Data Direction (DD) bit. If the appropriate 
DRE or DRF bit is already set when this bit is set, an 
immediate DMA request occurs. This DMA request is 
cleared by the adapter’s accessing the Data register or 
clearing the DTD bit. This bit is cleared upon a reset. 


Set Command Queue Full (SQF) 

The setting of this bit is reflected in the Command 
Queue Full (CQF) bit in the Status register. The 
adapter sets this bit to indicate to the host that 
co m mands cannot currently be accepted by the adapter. 
This bit is cleared upon a reset. 


Host Relinquish Interrupt Enable (HRI) 

If this bit is set, an interrupt is sent to the adapter 
whenever the Host Control (HC) bit is cleared in the 
Status register. If the HC bit is already cleared, an 
immediate interrupt will occur. The interrupt is cleared 
by the adapter’s reading the Status register. This bit is 
cleared upon a reset. 


Primary Commands 

Primary commands are those passed directly through 
the adapter’s Parameter register. These commands are 
used to perform the most primitive level of 
communication between the adapter and the host. 

Before a command is issued by either the host or the 
adapter, it must gain control of the interface. When the 
adapter desires control, it clears the Host Control 
Enable (HCE) bit in the Adapter Interface register and 
waits for the Host Control Request (HCR) bit in the 
Status register to be cleared. 

When the host desires control, it requests control by 
setting the HCR bit in the Host Interface register and 
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waits for the Host Control (HC) bit to be set in the 
Status register. The adapter can prevent the host from 
obtaining control of the interface by clearing the Host 
Control Enable bit in the Adapter Interface register. 
Normally the adapter prevents the host from gaining 
control only when the adapter is itself using the 
interface. However, when there is no memory space in 
the adapter to hold any more command blocks, the 
adapter can prevent the host from gaining control of 
the interface until memory space becomes available. 

The primary commands and their parameters are passed 
through the Parameter register. This register holds the 
primary command followed by up to 6 bytes of 
parameter data in a 7-byte shift register. Because of 
the nature of this register, exactly 7 bytes must be 
written to it. In cases where there are less than 7 bytes 
of parameter data, additional dummy bytes must be 
written after the real parameters to bring the total 
number of bytes written to 7. When reading this 
register it is not necessary to read these dummy bytes. 

The parameter data consists of a true 32-bit address of 
host memory. 

After interface control has been obtained and the 
command and parameters have been written to the 
Parameter register, the GO bit is set in the Status 
register. 

The side receiving the command can read the command 
and parameters and perform the desired action. If the 
command requires data to be transferred, the data is 
transferred through the Data register using the Data 
Register Full (DRF) and Data Register Empty (DRE) 
bits in the Status register to provide synchronization. 
On both sides of the interface, data can be transferred 
using DMA, interrupts, or polled 1/ O with each side 
able to independently select its mode of transfer. 

When the side receiving the command has completed 
the command, it clears the GO bit to indicate the 
primary command has been completed and includes the 
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primary command completion code in the Status 
register. Clearing the GO bit does not mean that 
secondary commands, that were passed by the primary 
command, have been accepted or completed. 
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Host-Initiated Commands 


Transfer Command Block to Adapter 


Command code: OlH 

Parameters: Command block address: low word, 

low byte 

Command block address: low word, 
high byte 

Command block address: high word, 
low byte 

Command block address: high word, 
high byte 
Length low byte 
Length high byte 

This command requests the adapter to accept a 
command block of the specified length that is stored in 
the host memory at the specified address. 

After issuing the command, the host begins writing data 
to the Data register, whenever the Data Register Empty 
(DRE) bit is set in the Status register, until the entire 
command block has been transferred. The host waits 
for the GO bit to be cleared by the adapter. 

The adapter, after reading the command, reads the 
parameters and performs whatever setup is required. It 
then reads the Data register when the Data Register 
Full (DRF) bit is set in the Status register and stores 
the data in its memory until the command block has 
been transferred. The adapter then clears the GO bit 
and loads the command completion code in the Status 
register to indicate the transfer has been completed. 

At some later time, the command block is examined by 
the adapter and any secondary command is executed, if 
possible. 
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Abort Secondary Command 


Command code: 

02H 

Parameters: 

Command block address: low word, 
low byte 

Command block address: low word, 
high byte 

Command block address: high word, 
low byte 

Command block address: high word, 
high byte 

Secondary command code byte 


This command requests the adapter to abort the 
secondary command found in the command block 
identified by the specified host address. After the abort 
has been attempted, the GO bit is cleared and the result 
placed into Status register bits CCO and CCl. 


Reconfigure Adapter 


Command code: OSH 

Parameters: Number of sessions 

Number of command blocks 

This command determines the allocation of the 
adapter’s RAM. It specifies the number of sessions and 
command blocks that the adapter should allocate (and 
hence the number of data buffers it can allocate). This 
command causes all current sessions and names to be 
removed from the name table. 

A maximum of 32 sessions and 32 command blocks can 
be specified. If more are specified, only 32 are 
allocated. If 0 is specified, the adapter uses its internal 
default value, (6 sessions and 12 command blocks). 


Hardware Description 3-43 



Adapter-Initiated Commands 

Initialization Complete 


Command code: 41H 

Parameters: Initialization status in the Parameter 

register 

80H-Successful completion 
81H-Processor test failed 
82H-ROM checksum test failed 
83H-Unit ID PROM test failed 
84H-RAM test failed 
85H-Host interface test failed 
86H-± 12V test failed 
87H-Digital loopback test failed 
8EH-Possible constant carrier 
8FH-Analog loopback test failed 

This command is issued by the adapter when it has 
completed its initialization after being released from the 
reset. Before issuing any commands to the adapter, the 
host waits for the adapter to issue this command. See 
“Power-On Self-Tests (POST)” on page 3-63 for a 
description of the tests. 


Transfer Data To Host 


Command code: 42H 

Parameters: Buffer address: low word, low byte 

Buffer address: low word, high byte 
Buffer address: high word, low byte 
Buffer address: high word, high byte 
Length low byte 
Length high t?yte 

This command requests the host to accept the number 
of bytes of data specified by the length field, and to 
store this data starting at the specified address. After 
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issuing the command the adapter begins writing data to 
the Data register, whenever the Data Register Empty 
(DRE) bit is set in the Status register, until all the data 
has been transferred. The adapter then waits for the 
GO bit to be cleared. 

After reading the command, the host reads the 
parameters and performs whatever setup is required. It 
then reads the Data register when the Data Register 
Full (DRE) bit is set in the Status register and stores 
the contents of the Data register in memory until all the 
data has been transferred. The host then clears the GO 
bit in the Status register to indicate the command has 
been completed, and places the command completion 
code in the Status register. 


Transfer Command Block To Host 


Command code: 43H 

Parameters: Command block address: low word, 

low byte 

Command block address: low word, 
high byte 

Command block address: high word, 
low byte 

Command block address: high word, 
high byte 
Length low byte 
Length high byte 

This command operates in the same manner as the 
Transfer Data to Host command except that a 
command block is being passed back. The appropriate 
host response to this command is to clear the GO bit. 

The GO bit is cleared after the transfer has been 
completed and before the control block is examined. 
This is to prevent tying up the adapter interface 
unnecessarily. 
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Transfer Data To Adapter 


Command code: 44H 

Parameters: Buffer address: low word, low byte 

Buffer address: low word, high b 3 d;e 
Buffer address: high word, low byte 
Buffer address: high word, high byte 
Length low b 3 d:e 
Length high byte 

This command requests that the host transfer the 
number of bytes of data specified by the length and 
starting at the specified address to the adapter. After 
issuing the command, the adapter waits for the data to 
be written to the Data register and continues reading 
the Data register until all the data has been received. 
The adapter then waits for the GO bit to be cleared by 
the host. 

After reading the command, the host reads the 
parameters and performs whatever setup is required. It 
then writes the requested data to the Data register until 
all the data has been transferred. The host then clears 
the GO bit in the Status register to indicate the 
command has been completed and places the command 
completion code in the Status register. 


Error Report To Host 


Command code: 45H 

Parameters: Error status in the Parameter register 

41H-Continuous carrier detected 
(Not this adapter) 

42H-Continuous carrier detected 
(This adapter) 

43H-No carrier detected 

50H — FEH-Internal software error 
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This command is issued by the adapter when it detects 
an irrecoverable error occurring after initialization. The 
host performs a report of the error to the operator and 
waits for manual intervention such as reset of the host, 
or a host diagnostic program that will reset the adapter 
and test for a specific failure symptom. 


Modem Interface Section 

The Sytek Serial Interface Controller SIC connects the 

RF modem to the Intel 82586 Local Communications 

Controller (LCC). The functions performed are as 

follows; 

• Generate a 2 MHz transmit clock (TXC) for the 
82586. 

• Encode the transmit data (TXD) from the 82586 
to the required non-return-to-zero-inverted 
(NRZI) format specified for the modem. 

• Decode the NRZI data received from the modem 
to the format needed by the 82586, receive data 
(RXD). 

• Recover the receive clock from the received data 
and drive the receive clock (RXC) function of the 
82586. 

• Perform the collision detect function while 
transmitting, and drive the CDT pin of the 82586. 

• Drive the carrier sense (CRS) pin of the 82586. 

• Detects network failures and reports the failure to 
the 80188 through an interrupt. 

• Place the SIC in a loopback/ diagnostic mode 
under control of the 80188 CPU. 
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Communications Controller Section 


This section uses the Intel 82586 and the Sytek Serial 
Interface Controller (SIC). The 82586 manages the 
process of transmitting and receiving packets. On the 
microprocessor side, this controller operates as a bus 
master. This means that both the 80188 
microprocessor and the 82586 can access the IBM PC 
Network Adapter’s local memory. 

There are two major control units in the 82586, the 
command unit and the receive unit. The two units are 
controlled and monitored by the microprocessor by a 
shared memory structure called the system control 
block. 

• The command unit executes commands given by 
the microprocessor and manages packet 
transmissions. 

• The receive unit handles all activities related to 
packet reception such as; buffer management, 
packet and address recognition, and CRC 
checking. 

The other two memory structures used by the 82586 
are the command block list and the receive packet area. 
The adapter memory holds the list of commands to be 
executed by the 82586, and all received packets. 
Pointers to these two structures are stored in the system 
control block along with the contents of the status 
register, the value of certain counters, and control 
commands for the 82586. 


CSMA/CD Technique 

A protocol that is widely used for broadband local 
networks is the carrier sense with multiple access and 
collision detection (CSMA/ CD) method. This method 
is supported in hardware on the adapter. The RF 
modem section detects the presence of a carrier. The 
Sytek Serial Interface Controller (SIC) detects 
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collisions. The 82586 Local Communications 
Controller (LCC) supports the higher levels of the 
protocol after proper configuration for slot time, 
back-off algorithm, retries, address filtering, data 
encapsulation, error detection, and other parameters. 

A method of detecting collisions in a broadband 
network is based on a comparison between the data 
sent by a node and the data received after a round-trip 
delay to the headend. This technique cannot guarantee 
100% detection of all collisions. A capture effect 
found in all frequency modulation systems allows the 
possibility that a particularly strong transmitter can 
capture the channel and take it away from a weaker 
transmitter. For power differences greater than 6 dB, 
the weak node backs off and the strong node assumes it 
has seized a quiet network. Proper cable system design 
effectively eliminates these undetected collisions. In 
any case, if an undetected collision occurs, the Link 
Access Protocol detects this as a CRC failure and 
retransmission occurs. The overall statistical behavior 
of the network is unaffected. When a collision has 
been detected by the SIC, it asserts the Collision 
Detected (CDT) input to the LCC. 
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RF Modem Section 


This section describes the RF Modem and its circuitry. 
The modem consists of a single coax tap modulator — 
demodulator (modem) with a data transfer rate of 2M 
bits per second to and from the network. The modem 
transmits to and receives from the network on separate 
channels. Each channel has a 6 MHz bandwidth, 
separated by a frequency offset of 168.25 MHz. The 
transmit center frequency is 50.75 MHz; the receive 
center frequency is 219.00 MHz. Both frequences are 
shared on the broadband network cable by all nodes 
through the use of the carrier sense multiple access with 
collision detection (CSMA/ CD) technique. These 
frequencies are aligned with CATV channels T-14 and 
J. 

The following is a block diagram of the RF Modem 
section: 
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Figure 3-10 RF Modem Block Diagram 
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Transmitter Description 

This section describes the transmitter circuits of the RF 
Modem. A block diagram of the transmitter section is 
as follows: 


Transmitter Key Line Transmit Data Line 

from Adapter from Adapter 



Diplexer Filter 


Figure 3-11 Transmitter Block Diagram 


• Modulator Driver 

The NRZI-encoded serial TTL data is applied to a 
driver stage that converts the TTL levels into mark 
and space voltages. These voltages are applied to 
the frequency-shift key (FSK) oscillator. The 
driver stage also functions as a low-pass filter to 
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remove the unwanted harmonic signals from the 
modulating signal. The modulation adjustment is 
factory set for a 2 MHz shift. 

• Voltage-Controlled Oscillator (VCO) 

The mark and space voltages are used to frequency 
shift key the VCO. The VCO operates at 50.75 
MHz. Also, the oscillator is temperature 
compensated to provide the necessary frequency 
stability. 

Within the VCO, are the following circuits: 

- Buffer/ Amplifier 

The output of the oscillator is buffered with a 
two-stage amplifier to minimize oscillator 
pulling and to provide sufficient level to 
overcome the loss in the bandpass filter. 

- Bandpass Filter 

The bandpass filter is used to band-limit the 
FSK signal. It also removes unwanted 
sidebands and harmonic signals at the 
amplifier output. 

• Gain-Controlled Amplifier 

The gain-controlled amplifier is factory adjusted 
and can provide up to 17 dB of gain. This stage is 
used to set the transmitter’s output level. 

• Output Amplifier 

The output amplifier provides 10 dB of gain and 
the high-level output needed to drive the cable 
system. 

• Low-Pass Filter 
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The low-pass filter is used to remove the harmonic 
signals generated by the amplifiers and the PIN 
diode switch. It also forms one leg of the band 
separator, which combines the transmitted and 
received signals on the coax cable. 


Transmitter Characteristics 


• Output Impedance 

The output impedance in the transmit channel is 75 
ohms nominal. 

• Return Loss 

The return loss is greater than or equal to 14 dB in 
the transmit channel with either power on or off. 

• Transmitter Load 

The transmitter can operate continuously into an 
open or short circuit without damage. Also, it can 
operate continuously into a cable system where 
other modem transmitters are enabled at the same 
time without damage. 

• Power Level 

The transmitter output level is set to 56 dBmV ± 1 
dB. The transmitter output level variation is within 
± 3 dB of its initial setting. 

• Frequency Allocation 

The transmitter operates on a center frequency of 
50.75 MHz. 

• Frequency Stability 

The frequency stability is ±0.6% of the transmit 
channel frequency. 
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• Modulation Technique 

The modulation technique used is frequency-shift 
keying (FSK). 

• Frequency Shift 

The frequency shift is 2 MHz ±200 kHz centered 
about 50.75 MHz. 

• Carrier Turn-on Delay 

The transmitter can reach 90% of full output 
power within 3 to 9 /xs of TX Key going low. 

• Carrier Turn-off Delay 

The transmitter can reach 10% of full output 
power within 3 to 9 /xs of TX Key going high. 

• Envelope Overshoot 

The maximum envelope overshoot is 25% during 
turn on and off. 

• Off Condition Output 

In the off state, the carrier signal level is -20 
dBmV or less. 

• Spurious Output Levels 

- From 5-10 MHz and from 100-900 MHz, the 
spurious output levels are -10 dBmV or 60 dB 
down from the carrier level; whichever is the 
greater signal level. 

- From 10-100 MHz, the spurious output levels 
are -21 dBmV or 78 dB down from the carrier 
level; whichever is the greater signal level. 

• Spectrum Shape (Bandwidth) 
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The modulated output spectrum is greater than or 
equal to 40 dB down at ± 3 MHz from the center 
frequency. The out-of-band power is 40 dB or 
more below reference carrier level at ±4 MHz 
from the center frequency. 
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Receiver Description 

This section describes the receiver circuits of the RF 
Modem. A block diagram of the receiver section is as 
follows; 


Signal from Diplexer Filter 



Data Output DCD Output 

to Adapter to Adapter 


Figure 3-12 Receiver Block Diagram 
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High-Pass Filter and One-Half Diplexer Filter 

The incoming signal to the modem is separated 
from the outgoing signal by the high-pass filter. 

Bandpass Filter 

The bandpass filter passes the 6 MHz bandwidth 
that is centered on the 219 MHz frequency. 

RF Amplifier 

The RF amplifier increases the signal level to 
compensate for the loss in the bandpass filter. 

Mixer 

The mixer combines the incoming 219 MHz signal 
with the 179.5 MHz local oscillator to provide a 
39.5 MHz intermediate frequency (IF). 

Crystal Oscillator 

The crystal oscillator starts the local oscillator 
chain at 89.75 MHz. 

Doubler 

The doubler multiplies the output of the crystal 
oscillator from 89.75 MHz to 179.5 MHz to 
provide the local oscillator injection for the mixer. 

First IF Amplifier 

The first IF amplifier provides about 23 dB of gain 
to compensate for the loss through the saw filter. 

Saw Filter 

The saw filter selects signals only within the 
desired IF pass-band and attenuates signals outside 
this band. 
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Second IF Amplifier 


The second IF amplifier provides 30 dB of gain 
needed for the necessary input level for the 
limiter/ demodulator circuit. 

• Tuned Circuit 

The tuned circuit provides impedance matching 
and increases out-of-band attenuation. 

• Limiter/Discriminator 

The limiter/ discriminator provides amplitude 
limiting of the input signal and demodulates the 
FSK signal with a quadrature detector. The limiter 
also provides a relative signal strength indication to 
operate the data carrier detect (DCD) comparator. 

• Data Comparator 

The data comparator converts the analog signal 
into a TTL-compatible digital signal. 

• DCD Comparator 

The DCD comparator produces a TTL-compatible 
output signal to indicate the presence of an 
incoming signal. 


Receiver Characteristics 


• Input Impedance 

The standard impedance is 75 ohms nominal. 

• Return Loss 

The return loss is 14 dB or more in the receive 
channel with power on. With power off, the return 
loss is 8 dB or more in the receive channel. 
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Frequency Allocation 

The receiver operates on a center frequency of 
219.0 MHz. 

Frequency Stability 

The frequency stability after a 10-minute warm-up 
period is within 0.01% of the receive channel 
frequency. 

Reception Acceptance Range 

The receiver demodulates incoming signals within 
±0.177% of the receive channel center frequency. 

Channel Bandwidth 

The receiver has a 3.6 MHz channel bandwidth. 
Sensitivity 

The normal input level is +8.5 dBmV. Operating 
range is -7 dBmV to +24 dBmV. The input 
sensitivity for 20 dB S/N at the demodulator 
output is less than or equal to -13 dBmV. 

Minimum quieting at 0 dBmV is 30 dB. The 
maximum sustained input level without damage to 
the receiver is +61.25 dBmV. 

Recovered Data 

The jitter on the demodulated data out of the 
receiver data comparator does not exceed ± 150 ns 
with an input signal of -7 dBmV modulated with a 
1 MHz square wave. 

Receive Carrier Detect 

The carrier detect threshold is between -20 and -8 
dBmV. The DCD line will go true within 4.0 fis of 
a -7 dBmV signal being present at the input of the 
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modem. The rise and fall time for the output of 
the DCD comparator from 10% to 90% of the 
steady state output is less than or equal to 500 ns. 
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Adapter Interface Signals 

Each input line to the IBM PC Network Adapter 
presents a maximum of one LS TTL load to the 
Personal Computer bus. All IBM PC Network Adapter 
output signals to the Personal Computer bus are driven 
by tri-state drivers. 

Without WAIT states being generated, all Personal 
Computer processor-generated memory read/ write 
cycles take four time (T) states. All Personal 
Computer processor-generated 1/ O read/ write and 
DMA transfers require five T states. See your IBM 
Technical Reference for more information about your 
computers DMA transfers. 

The following Personal Computer interface signals are 
used by the IBM PC Network Adapter. 


Signal 

I/O 

Description 

A0-A19 

■ 

These lines are used to address the BIOS 
memory and adapter I/O interface registers. 

D0-D7 

I/O 

These lines provide a bidirectional data bus for 
the Personal Computer processor, Personal 
Computer memory, and adapter. 

ALE 

■ 

Address latch enable, which is used as an 
indicator of a valid Personal Computer processor 
address to the adapter. 

IOR_ 

■ 

This command line instructs the adapter to drive 
its data onto the Personal Computer data bus. 

IOW_ 

■ 

This command line instructs the adapter to read 
the data from the Personal Computer data bus. 

MEMR_ 

I 

This command line instructs the BIOS ROM to 
drive its data onto the Personal Computer data 
bus. 

IRQ2 and 

1RQ3 

i 

0 

Interrupt request 2 or 3 is used to signal the 

Personal Computer processor that the adapter 
requires attention. 


Figure 3-13 (Part 1 of 2). Personal Computer/ Adapter 
Interface Signals (from Adapter) 
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Signal 

I/O 

Description 

DRQ3 

0 

DMA Request 3 is used by the adapter to gain 

DMA service from the Personal Computer. 

DACK3_ 

■ 

DMA Acknowledge 3 is used to acknowledge 

DRQ3 which is requested by the adapter. 

I/O CH RDY 

0 

I/O Channel ready is used to allow the Personal 
Computer to generate WAIT states to extend the 
Personal Computer clock cycle up to a maximum 
of 2.1 jLtsec. 

RESET DRV 

■ 

This line is used to reset or initialize the adapter 
logic upon power-up or after a low line voltage 
outage. 

T/C 

■ 

Terminal Count: This line provides a pulse that Is 

gated with DACK3 which may generate a 

Personal Computer interrupt request whenever 
the terminal count for the Personal Computer's 

DMA channel 3 is reached. 


Figure 3-13 (Part 2 of 2) Personal Computer/ Adapter Interface 
Signals (from Adapter) 
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Power-On Self-Tests (POST) 

The IBM PC Network Adapter provides a pass/fail 
indication to the Personal Computer, as long as the 
interface is functioning. If the adapter is functioning 
but the adapter-Personal Computer interface fails, the 
error is posted at power-on time. The adapter responds 
to any requests for remote status from other computers 
on the network indicating that a failure has occurred. 

The following is a list of tests, in order, that are 
performed by the adapter. 

1. Microprocessor Self-test 

The 80188 microprocessor performs limited 
self-test of its functions and certain peripheral 
circuits that are integrated within the 80188 
microprocessor. 

The tests are conditional jump test and register 
write test. The conditional jump test verifies the 
proper execution of all conditional jump 
instructions when the corresponding status flags 
are in the set/ reset conditions. The register write 
test verifies the entire register set by writing and 
then chain-copying a certain data pattern (and its 
complement) to all registers, and then reading and 
comparing the register’s final contents with the 
original data pattern. 

The peripheral tests are interrupt mask test, 
spurious interrupt test, and timer 1 test. The 
interrupt mask test performs the write, read and 
compare operations to the Interrupt Mask Register 
(IMR) by using both all ones and all zero patterns. 
The spurious interrupt test verifies that no spurious 
interrupts are generated by the hardware when all 
interrupt masks are off. The timer 1 test verifies 
the proper operation of timer 1 and timer interrupt. 
Timer 1 is used as the 10-ms clock in the system. 
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If the adapter fails the microprocessor self-test, it 
will execute a halt instruction. 

2. ROM Checksum 

Following the microprocessor self-test, a ROM 
checksum is performed using simple modulo 
addition expecting an all zeros result. This 
assumes that a precalculated checksum byte stored 
in the ROM will provide a zero result. 

The adapter executes a halt instruction, if the 
results of the addition are not correct. 

3. Unit ID PROM Test 

Following the ROM checksum test, the unit ID 
PROM is tested by verifying that the byte at 
location lAH in the PROM has the value of OOH. 
The unit ID is also checked for having a low bit of 
zero (because it must be even). 

4. RAM Test 

Once the microprocessor, PROM, and ROM have 
passed their tests, the RAM is tested and also the 
RAM refresh is tested. The dynamic RAM is 
refreshed by DMA 1 , which is driven by timer 2 
periodically. The RAM test verifies the operation 
of the RAM, DMA 1, timer 2, and timer interrupt. 

If the RAM is not functional, the adapter cannot 
perform its intended application. An error is 
reported by using the adapter-Personal Computer 
interface. Since both digital and analog cable 
loopbacks require functioning RAM, the adapter 
does not perform these tests and continues on to 
the adapter-Personal Computer interface test 
reporting that the RAM test failed. 

5. Host Interface Tests 
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This test is functionally separated into five 
sub-tests. The first portion of the Host Interface 
register test is a stand-alone test that requires no 
involvement from the host software. The 
subsequent tests require synchronization and 
cooperation with the host software. The five 
sub-tests are as follows: 

a. Host interface register test 

b. GO interrupt test 

c. Data transfer interrupt test 

d. Data transfer DMA test 

e. Host interface control test 

The adapter requires an initial synchronization 
from the BIOS ROM. Within 500 ms. of the host’s 
clearing the reset bit, the BIOS sets the CCl and 
GO bits in the Status register. 

a. Host Interface Register Test 

This test verifies the various functions and 
characteristics of the Data register, the 
Parameter register, the Adapter Interface 
register and the Status register. The Host 
Interface register is not accessible from the 
adapter. Therefore, the testing of the Host 
Interface register is done by the BIOS. 

Proper operation of the Data register is 
verified by writing, reading, and comparing a 
AAH/55H data pattern in a certain sequence. 
In addition, the DRF and DRE flags are 
verified accordingly. 

Proper operation of the Parameter register is 
tested by writing, reading, and comparing with 
a AAH/ 55H/ xxH/ xxH/xxH/ xxH/ xxH data 
pattern where (xx) is a don’t care value. 
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Proper operation of the Adapter Interface 
register is verified by writing, reading, and 
comparing with a A AH/ 5 IH data pattern. In 
addition, the CQF flag is tested accordingly. 

Proper operation of the Status register is 
tested by writing a OSH (and then a 02H) to 
the Status register, reading the Status register 
and testing for 15H (and then 12H). Note 
that the write with 02H provides a means to 
synchronize with the host software. 

b. GO Interrupt Test 

This test verifies that the GO interrupt is sent 
by the host and is received by the adapter. 

This test also verifies that the GO interrupt is 
sent by the adapter and is received by the 
host. This test requires cooperation with the 
host’s software. 

c. Data Transfer Interrupt Test 

This test verifies that the data transfer 
interrupts (both read and write interrupts) are 
received by the adapter when the Status 
register and Adapter Interface register are 
properly configured. This test also verifies 
that the data transfer interrupts are received 
by the host. This test requires cooperation 
with the host’s software. Note that this test 
verifies the interrupt mechanism, not the 
integrity of the data being transferred through 
the interrupts. 

d. Data Transfer DMA test 

This test verifies that two data bytes are 
transferred to the adapter by DMA with a 
DMA interrupt. This test also verifies that the 
two data bytes are returned to the host with 
the TC interrupt. The host’s software is 
required to test and validate the data bytes 
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returned from the adapter to ensure the 
integrity of the data transfers. This is 
performed by the BIOS after a reset. 

e. Host Interface Control Test 

This test verifies the various functions that are 
related to the ownership of the interface. 
Functions tested include the following: 

1) The adapter’s inability to acquire control 
of the interface when the interface is 
controlled by the host. 

2) The adapter’s ability to acquire control of 
the interface after the host relinquishes 
control of the interface. 

3) The host’s ability to acquire control of 
the interface after the adapter 
relinquishes control of the interface. 

4) The host’s inability to acquire control of 
the interface when the interface is 
controlled by the adapter. 

5) Generation of the Host Control interrupt 
and the Host Relinquish interrupt. This 
test requires cooperation with the host’s 
software. 

+ 12 Volt and -12 Volt Presence Test 

This test checks the presence of the Personal 
Computer’s -t-12 V and -12 V power supplies. 
When either of the two supplies are below the 
sense level voltage, a ‘ ± 12V not present ' 
condition is provided to the IBM PC Network 
Adapter microprocessor. When both of the 
supplies are above the sense level voltage, a ' ± 
12V present ’ condition is provided to the IBM PC 
Network Adapter microprocessor. 
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7. Digital Serial Loopback 

After first initializing the 82586, a test is 
performed using the loopback points of the SIC 
integrated circuit. The two circuits tested are the 
integrated circuit and the adapter interface circuits. 
The following tests or error states are created and 
tested in loopback mode. 

• Diagnose Command of the 82586 

• No Error Packet 

• Short Frame 

• CRC Error 

The adapter cannot perform its function if the 
digital serial interface is not functioning. The 
analog cable loopback test cannot be performed if 
the digital serial interface is not working properly. 
The adapter reports the status of a failure to the 
Personal Computer. 

8. Analog Cable Test 

At this point, all tests have been performed 
independent of external equipment and support. 

To perform the analog cable loopback test, a 
frequency translator is needed to provide 
frequency translation. The test also assumes that 
the cable can contain active functional traffic, so 
the adapter must respect the cable protocol. The 
adapter tries to send a test packet addressed to 
itself. Because collisions might occur, this test will 
try eight times to send a packet and receive it back. 
If the analog self-test fails, the adapter reports a 
cable loopback test failure to the Personal 
Computer. At this point, the adapter may have 
errors, but it functions normally with respect to the 
Personal Computer. 
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A failure at this point could be because of a 
problem in the RF Modem section or an external 
failure. The test fails if eight consecutive tries end 
in collisions or the test packet did not return. The 
adapter reports the status of a failure to the 
Personal Computer. 


Operational Self-Test 

This test is run under normal operation of the adapter 
and will generate a return code posting the error. 

Constant Carrier Detection — The Sytek SIC contains 
circuitry to detect a constant carrier and to inform the 
IBM PC Network Adapter processor. The adapter 
processor causes the 82586 to abort any transmitting 
packet in progress. The constant carrier status is 
reported to the Personal Computer by the primary 
command Error Report. 
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Configurable Hardware Options 

This adapter contains six configurable jumper positions. 

• Jumper W1 is the remote program load (RPL) 
feature. Removing the jumper enables the feature. 

• Jumper W2 is a reserved jumper. 

• Either jumper W3 or W4 is used to select IRQ. 

The interrupt must be different from any adapter 
in your computer. With the jumper in the W3 
position, interrupt level 2 is selected. With the 
jumper in the W4 position, interrupt level 3 is 
selected. 

• One jumper W6 on the center pins of W5 and W7 
selects the high 1/ O base address. Use two 
jumpers, W5 and W7, to select the low I/O base 
address. See Figure 3-2 on page 3-26 for the 
addresses of the registers. 

• One jumper W8 is used to disable or enable the 
BIOS ROM. When the jumper is installed, the 
BIOS ROM is enabled. 

The state of jumpers W1 and W2 is reported back to 
the Personal Computer. See network control block 
ADAPTER STATUS in Chapter 2 for more 
information. 

The following figure illustrates the jumper positions on 
the adapter. 
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Figure 3-14 Adapter Jumper Positions 
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Traffic And Error Statistics 

The adapter keeps and reports on demand some of the 
following statistics; 

• Duration of reporting period 

• Quantity of CRC errors received 

• Quantity of alignment errors received 

• Quantity of collisions encountered 

• Quantity of aborted transmissions 

• Quantity of successfully transmitted packets 

• Quantity of successfully received packets 

• Number of times the receiver exhausted its 
resources 

The reporting period for the IBM PC Network Adapter 
is from last reset as expressed in minutes. No provision 
is made for resetting the statistics other than a Personal 
Computer reset of the adapter or power-up of the 
Personal Computer. See network control block 
ADAPTER STATUS in Chapter 2 for more 
information. 
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Specifications 

This section summarizes basic specifications of the 
hardware of the IBM PC Network Adapter. 

Electrical Power Requirements 

The specifications of the power requirements are as 
follows. 


Voltage 

Tolerance 

Ripple 

Total 

Current Used 

-1-12.0V 

±5% 

100 mV pp 

0.36 A 

-I-5.0V 

±5% 

100 mV pp 

1.40 A 

-12.0V 

±10% 

100 mV pp 

0.03 A 


Environmental Specifications 


Temperature The operating temperature range is from 
10 to 35°C, (50 to 91 °F) ambient. The 
storage temperature range is from -40 to 
60°C, (-40 to 140°F). 


Humidity The operating humidity range is from 
8% to 80% non-condensing. The 
storage humidity range is from 5% to 
100% non-condensing. 

Altitude The operating altitude is -305 to 2135 

meters (-1000 to 7,000 feet). 
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IBM Translator Unit 


This section describes the specifications of the 
translator unit for the IBM PC Network 

The translator unit provides the basic frequency 
translation and amplification required in a broadband 
network. A single translator unit can serve a network 
comprising many local area network adapters and their 
attached devices. 


Device Description 

This section briefly describes the translator unit and 
discusses its functions as shown on a block diagram. 

This translator unit is implemented on a printed circuit 
board that fits inside an enclosure designed to meet 
FCC Class B. The enclosure also includes the required 
power supply circuits. The translator unit is designed 
for high reliability, and has no "field" adjustments. 


Functional Description 

The function of this unit is to translate a channel with 
an input center frequency of 50.75 MHz from the 
network into a channel with an output center frequency 
of 219 MHz, with the required spectral purity and 
signal level. The entire 6 MHz channel is translated 
from the lower band to the upper band. 
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The following is a block diagram of the IBM Translator 
Unit. 


Signals from LAN 



Figure 3-15 Translator Unit Block Diagram 
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The block diagram can be divided into four main parts 
discussed in the following sections: 

• Input/ Output circuits 

• Reception circuits 

• Local oscillator circuits 

• Transmission circuits 


Input/Output Circuits 


Diplexer Filter A conventional low-loss band 

separator with a stop-band 
attenuation of 25 dB. Its 
function is to prevent the 
transmitted signals from 
entering the reception path, 
and to limit the amount of 
unwanted signals entering the 
translator. 


Reception Circuits 


Bandpass Filter FIR Has a center frequency of 

50.75 MHz and a bandwidth of 
approximately 6 MHz. This 
device filters out most 
out-of-band signals, lowering 
the input intermodulation 
requirements of the amplifier 
that follows it. 


RF Amplifier A 25 dB low-noise amplifier 

providing the required signal 
level to the mixer, for best 
intermodulation and low loss 


3-76 Hardware Description 



performance. Its output is 
matched to the mixer’s 50 ohm 
impedance. 

Mixer A high-performance 

double-balanced mixer. Its 
local oscillator tap requires a 
+1 dBm signal level for 
optimal operation. 


Local Oscillator Circuits 


Crystal Oscillator A common emitter oscillator 

whose frequency is controlled 
by a high-stability crystal. This 
oscillator provides the required 
frequency stability for the unit. 

Amplifier and Filter Provides a 4-7 dBm signal to 

the local oscillator’s mixer tap 
with the required spectral 
purity for having the lowest 
spurious level from the mixer. 


Transmission Circuits 

A typical output signal level of -1-50.25 dBmV is 
provided to the trunk, after a translator gain of 36 dB 
(typical). 

Bandpass Filter FIT Removes unwanted 

out-of-band products from the 
mixer’s output, and matches 
the amplifier’s input impedance 
to the mixer’s 50 ohm 
impedance. 

RF Amplifier Amplifies the signal to the 

required output level, providing 
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25 dB gain. It is based on a 
low-distortion solid state 
design. 

Bandpass Filter F2T Removes unwanted products 

generated in the amplifier and 
provides the ultimate 
attenuation of all unwanted 
out-of-band signals reaching it. 
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The IBM PC Network Cable System 


This section describes the cable system components 
used in the IBM PC Network. The connection 
hardware and kits used in the IBM PC Network are 
compatible with broadband cable TV components. 
Signal levels are predesigned to provide the necessary 
tolerance for each IBM PC Network Adapter. A fully 
configured network, using IBM components, can 
support 72 nodes with a maximum radius of 1000 feet. 


Cable System Components 

The cable system consists of six components: 

• The Translators Unit’s connection hardware 

• Base Expander 

• Short Distance Kit 

• Medium Distance Kit 

• Long Distance Kit 

• IBM coaxial cable in either 25, 50, 100, or 200 
feet increments 


Translator Unit’s connection hardware 

These components allow attachment of up to eight 
computers to the Translator Unit. A directional coupler 
is provided within the components to allow connection 
for the IBM Base Expander. 


Base Expander 

When this component is attached to the connection 
hardware, it allows connection for up to eight Short, 
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Medium, or Long Distance Kits. Signal levels at the 
taps on the Base Expander are not compatible with the 
Adapters. A Test Tool is provided for diagnostic 
purposes. 


Short Distance Kit 

This kit attaches to any of the eight taps on the Base 
Expander. The kit allows you to connect up to eight 
computers. 


Medium Distance Kit 

This kit attaches to any of the eight taps on the Base 
Expander through an additional 400 feet of cable. The 
kit provides connection for up to eight computers. 


Long Distance Kit 

This kit attaches to any of the eight taps on the Base 
Expander Kit through an additional 800 feet of cable. 
The kit provides connection for up to eight computers. 


IBM Coaxial Cable 

The cable is standard RG-1 1 type coaxial cable 
providing different lengths: 25, 50, 100, and 200 feet. 
These cable increments can be combined to provide the 
400 and 800 foot lengths required by the Medium or 
Long Distance Kits. For the 400 feet length, you must 
use either four 100 foot lengths or two 200 foot 
lengths. For the 800 foot length, you must use four 
200 foot lengths. In addition, up to 200 feet of cable 
can be installed between the kit and each computer on 
the network. For the 200 foot lengths, you must not 
use eight 25 foot cables. 

The following figure illustrates how the previously 
described components are connected together. 
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Connection Hardware 


The connection hardware consists of a 5 foot black 
RG-6 cable, a directional coupler, a one foot beige 
RG-6 cable, and an 8-way splitter. The taps on the 
8 -way splitter provide the signal levels compatible with 
the adapters. The expansion tap on the directional 
coupler provides an unattenuated signal for attachment 
of a Base Expander. If a tap on the 8-way splitter is to 
be used, the terminator must be removed. If a tap is to 
be discontinued, the terminator must be replaced. 
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Electrical Specifications 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) * 

39.9 dB ±1.5 

-Attenuation, (reverse path) * 

39.9 dB ±1.5 

-Insertion loss, (forward path) ** 

0.7 dB 
maximum 

-Insertion loss, (reverse path) ** 

0.5 dB 
maximum 

-Isolation, node to node 

18 dB 
minimum 
(forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(forward and 
reverse 
paths) 


Note: Forward path is 219 MHz. Reverse path is 
50.75 MHz. 

* Translator Unit tap to any tap on the 8-way 
splitter. 

** Translator Unit tap to the expansion tap. 
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Base Expander 

This component consists of an 8 -way splitter and a 
male adapter. The taps on the 8-way sphtter provide 
signal levels compatible with either the Short, Medium, 
or Long Distance Kits. The signal levels at the taps of 
the splitter have not been attenuated enough to allow 
attachment of an adapter. A 30 dB attenuator is 
provided as a test connector for diagnostic purposes. 
The test tool allows connection for an adapter to the 
Base Expander. 



Note: 

For the Medium and Long Distance kits, 400 
or 800 feet of cable must be installed between 
the kit and the Base Expander. 
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Electrical Specifications 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) 

9.5 dB ±0.5 

-Attenuation, (reverse path) 

9.5 dB ±0.5 

-Isolation, (node to node) 

18 dB 
minimum 
(Forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(Forward and 
reverse 
paths) 


Note: Forward path is 219 MHz. Reverse path is 
50.75 MHz. 
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Short Distance Kit 


This kit consists of a 1 foot beige RG-6 cable, a 20 dB 
attenuator, and an 8 -way splitter. The taps on the 
8-way splitter provide signal levels compatible with the 
adapters. 



Note: 

Up to 200 feet of cable may be installed between 
the Adapter and the 8-way splitter. 
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Electrical Specifications 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) 

29.8 dB ±1.0 

-Attenuation, (reverse path) 

29.6 dB ±1.0 

-Isolation, (node to node) 

18 dB 
minimum 
(forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(forward and 
reverse 
paths) 


Note: Forward path is 219 MHz. Reverse path is 
50.75 MHz. 
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Medium Distance Kit 


This kit consists of a 10 dB tilt attenuator, an 8 dB 
attenuator, a 1 foot beige RG-6 cable, and an 8-way 
splitter. The taps on the 8-way splitter provide signal 
levels compatible with the adapters. The 10 dB tilt 
attenuator compensates for the attenuation versus 
frequency characteristics of the 400 foot length of cable 
between the Medium Distance Kit and the Base 
Expander. 
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Note: 

Up to 200 feet of cable may be installed between 
the Adapter and the 8-way splitter. 
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Electrical Specifications 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) 

19.7 dB ±1.1 

-Attenuation, (reverse path) 

26.6 dB ±1.8 

-Isolation, (node to node) 

18 dB 
minimum 
(forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(forward and 
reverse 
paths) 


Note: Forward path is 219 MHz. Reverse path is 
50.75 MHz. 
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Long Distance Kit 

This kit consists of a 5 dB tilt attenuator, a male 
adapter, a 10 dB tilt attenuator, a 1 foot beige RG-6 
cable and an 8-way splitter. The taps on the 8-way 
splitter provide signal levels compatible with the 
adapters. The 5 and 10 dB tilt attenuators compensate 
for the attenuation versus frequency characteristics of 
the 800 foot length of cable between the Long Distance 
Kit and the Base Expander. 
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(10 dB) 


Note: 

Up to 200 feet of cable may be installed between 
the Adapter and the 8-way splitter. 
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Electrical Specifications 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) 

12.7 dB ±0.8 

-Attenuation, (reverse path) 

23.0 dB ±1.8 

-Isolation, (node to node) 

18 dB 
minimum 
(forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(forward and 
reverse 
paths) 


Note: Forward path is 219 MHz. Reverse path is 
50.75 MHz. 
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IBM Coaxial Cable 


All cable lengths are RG-1 1 coaxial cable with male 
connectors on both ends of the cable. One end has a 
female-to-female adapter and a 75 ohm terminator 
attached to the male connector. Cables can be 
combined by removing the 75 ohm terminator and 
joining the male end of one cable to the female adapter 
of the other. When building the 400 and 800 foot 
lengths of cable required by the Short and Medium 
Distance Kits, use 200 foot increments of cable to limit 
the number of cable connections required. When 
building cable lengths for installation between an 
Adapter and an 8 -way splitter, no more than 3 cables 
should be combined. 


Cable Characteristics 

The IBM Cable has the following characteristics: 

. RG-11 

• Copper-covered steel-center conductor 

• Gas-expanded polyethylene dielectric 

• Inner shield of aluminum-polypropylene-aluminum 
laminated tape bonded to the dielectric 

• #34 AWG bare aluminum braid wire 

• Non-bonded aluminum-polypropylene-aluminum 
tape 

• #34 AWG bare aluminum braid wire 

• Jacket of polyvinylchloride 

• Nominal outside diameter 0.405 inch (10.29 mm). 
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Electrical Specifications 


-Impedance 


75 ohms 
nominal 


-Attenuation (at 20° C per 100 ft.) 


5 MHz 

0.29 dB 

55 MHz 

0.96 dB 

83 MHz 

1.18 dB 

187 MHz 

1.75 dB 

211 MHz 

1.90 dB 

250 MHz 

2.05 dB 

300 MHz 

2.25 dB 

-Return Loss (5-300 MHz) 

30 dB 
minimum 
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Cable Network Specifications 

• Channel Assignments 

Return Channel T-14 50.75 MHz 

Forward Channel J 219 MHz 

• RF Connector 

The RF connector is a type F connector. The RF 
connector is grounded on the adapter and is 
grounded on the Translator Unit. 

• RF Input/ Output 

The RF input/ output is transformer coupled. 

• RF Modem Signal Timing 

Figure 3-16 shows typical modem signal timing. 
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TX.KEY 



TX.CARRIER 


RECEIVED 

CARRIER 




t1 = 1.5 M sec 

t2,t4 = Channel Propogation Delay 

t3 = 1 M sec 

t5 = 1 .3 M sec 
t6,t8 = 1 .3 M sec 


t7 = 3.5 II sec 
t9 = ± 1 M sec 
tIO = ± 1.75 II sec 
t1 1 = ± 1 50 // sec 


Figure 3-16 RF Modem Typical Timing Diagram 
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• Error Rate Versus S/N Ratio 

The minimum input for a bit error rate of 1 in 10* 
is -7 dBmV with an input S/N ratio of at least 33 
dB. 

If these minimum conditions are met, then the IBM 
PC Network adapter has a bit error rate of less 
than 1 error in lO^* bits after CRC detection and 
retry. 

• Complete Cable Network overview 

Figure 3-17 shows the complete network signal losses 
and attenuation values. See Appendix B for the 
complete network specifications. 
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Electrical Specifications 

The following specifications apply to any version of the 
cable network, from a minimum 8-node configuration 
to a maximum configuration of 72 nodes. 


-Impedance, (any node) 

75 ohms 
nominal 

-Attenuation, (forward path) * 

41.75 dB 
±4.5 

-Attenuation, (reverse path) * 

41.75 dB 
±3.0 

-Isolation, (node to node) 

18 dB 
minimum 
(forward and 
reverse 
paths) 

-Return loss, (any node) 

14 dB 
minimum 
(forward and 
reverse 
paths) 

Note: Forward path is 219 MHz. 
50.75 MHz. 

Reverse path is 


Note: (*) Includes all cable between the 
Translator Unit and the Adapter. 
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Introduction 


This chapter discusses how to design a Local Area 
Network using the IBM Translator Unit, and IBM PC 
Network Adapters within each of the Personal 
Computers. Most of this information deals with the use 
of either the Short, Medium, or Long Distance Kits and 
how to combine components in a facility to connect 
your Personal Computers. The components in the IBM 
PC Network cable system are designed to easily 
connect up to 72 nodes. The Translator Unit can only 
be used on a passive data type of network. If the Short, 
Medium, or Long Distance Kits do not meet your 
network requirements, then the information here will 
assist you in designing your own network. If your 
requirements are for other simultaneous network 
services, then you must use another commercially 
available frequency translator with the proper filters. 

The basic principles used in network design are 
described. Following the procedures described here 
will help you to configure a network using either the 
Short, Medium, or Long Distance Kits. If you need to 
expand beyond the capabilities of the kits, the same 
principles apply to larger networks. You can design 
larger networks that will work properly if the proper 
signal level is delivered from the Translator Unit to 
each node, and to the Translator Unit from each node. 

When the necessary signal level cannot be delivered to 
a node, you can add amplifiers to extend the range of 
the network but not with the IBM Translator Unit. 
However, the design of such networks is beyond the 
scope of this book. Professional broadband or CATV 
network design engineers should be consulted to ensure 
the successful design of such networks. It is 
recommended that any network extending beyond the 
range possible with the cable kit be designed, or at least 
the plans reviewed, by an experienced network/ CATV 
design professional. Such a consultation can help to 
identify possible problems with installation, design and 
use, both now and in the future. 
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Network design involves many steps. The design task 
using the IBM PC Network is much simpler than if you 
were starting from scratch. The medium, topology, 
access method, and frequencies are all defined. If you 
choose to design your own network, you need to 
consider the following approach to the design: 

• Reviewing your needs 

• Surveying the physical layout 

• Designing the network 

• Installation of the network 

• Certification of the layout 


Reviewing Your Needs 

The first step in designing your IBM PC Network is to 
decide how the network will be used, who will use it, 
and where they will use it. 

The IBM PC Network is used to transfer data among 
different Personal Computers within a local area. In 
addition, with the proper frequency translator, a 
network like this can also be used to carry voice and 
video signals. Keep these additional applications in 
mind when deciding where to place the outlets and run 
the cable. 

If you have an existing base of Personal Computers and 
you \yant to connect these to the network, part of your 
survey is already done. You know who will use the 
network and where some of the outlets need to be. If 
you do not have any Personal Computers currently 
installed, you need to determine where they will be 
located. Estimate where additional nodes for future 
expansion should be placed, and plan your layout 
accordingly. 
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Surveying the Physical Layout 

The following procedures can guide you in the 

surveying task. 

1. Obtain a scaled drawing of the entire facility. 
Architect’s blueprints are best, but if you’re only 
interested in wiring a suite of offices, a small 
sketch that you draw yourself will suffice. 

2. Mark the locations that you know will be network 
outlets. These locations could be areas that 
already contain Personal Computers or will have 
them in the future. Mark these locations on the 
drawing as close as possible to where the actual 
connection outlet will be required. 

3. Add to this drawing one cable outlet for every 
desk, or one that could be shared by a cluster of 
desks. Planning for this kind of expansion might 
seem excessive now, but it could save extensive 
rewiring later. 

4. Note hallways and other areas suitable for routing 
the main cable from the Translator Unit to the 
outlets. Mark possible paths on the drawing for 
selection of the routes. 

5. Decide on a location for the frequency translator. 
In a larger network, place the frequency translator 
in a central location to keep cable branches short. 
Also, mark the location of the power outlet for the 
translator. 


Expanding Beyond the Cable Kit 

When your network requires more taps or a longer 
cable run than is possible to achieve with the cable kit, 
you must verify that the signal level delivered to each 
node on the network, including the frequency 
translator, is correct. If you cannot verify this yourself, 
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you can obtain help from broadband/ CATV design 
engineers or from cable installation consultants that 
have the capability. 


Physical Layout 

The purpose of the building survey is to plan distances 
for the network. Check the materials and construction 
of the facility’s walls, ceilings, and floors wherever you 
install the cable. From this survey, a more detailed plan 
for where to place and how to secure the cable should 
evolve. Many options are possible, above a false 
ceiling, in a conduit raceway, or cable clamped to the 
wall. If this is a bigger job than you can or want to 
handle, call in a contractor. If you don’t know exactly 
what is required by local building codes, some advice 
from a professional consultant is well worth the cost. 

The drawings for the building can be helpful to a 
contractor because they reveal materials used, they 
show what is behind walls, ceilings, and floors, and they 
help identify cable pathways. There might be existing 
cable conduit or trays for installing such wiring. The 
drawings should show these in detail. 

When installation starts, make any changes to the 
original drawing as they occur. This is very helpful 
when you are using the drawing for problem 
determination. 

The cost of the installation depends on many factors. 

A contractor experienced in laying cable knows the 
right questions to ask, and might suggest some 
alternative approaches. The complexity of the 
installation is also affected by your requirements, such 
as: 


• Local Fire and Electrical codes 

• How the cable will be routed 

• Whether outlet boxes and plates will be used 
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Component Description 

The following describes some of the components used 
in broadband networks. Some general specifications 
are also described. When designing a network, you 
need to identify these specifications in order to select 
the correct components. 

Passive components are used to distribute the signal 
power to the necessary outlets. Each component has its 
own function as follows: 


Splitters 

Splitters divide or combine power. The power division 
causes an insertion loss of approximately 10 log n(dB) 
where "n" equals the number of power splits. The 
splitter has internal losses caused by impedance 
mismatches and resistive losses. Isolation prevents any 
power passing between the lines that have been split. 
For a two-way splitter, signals and power are 
symmetrically divided into two separate lines. When a 
two-way splitter is used, the line that was split will have 
a 3 dB level reduction and a 0.5 dB internal loss. The 
total insertion loss is approximately 3.5 dB. 


Directional Taps 

The directional tap removes a small amount of power 
from the Une input, causing an insertion loss to the line 
output. A directional tap is a 3 connector device 
consisting of a line input, line output, and a tap off port. 
The directional tap removes a small amount of power 
from the line input and directs it to the tap-off port. 

The difference in amplitudes between the Une input and 
the tap off port is referred to as the tap attenuation 
value. Efficient removal of required signal levels leaves 
the majority of line power intact, capable of suppling 
many more taps. 
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The insertion loss in the tap occiu-s between the line 
input and the line output. The tap attenuation occurs 
between the hne input and the directional tap port. The 
isolation occurs between the directional tap port and 
the line output port. 


Tilt Compensators 

Coaxial cables have attenuation that varies with 
frequency. The higher the frequency, the higher the 
attenuation. This effect is known as tilt. Tilt 
compensators have attenuation that varies with 
frequency. The higher the frequency, the lower the 
attenuation. 

These devices equalize cable tilt so that the attenuation 
at both the high and low frequencies are the same. The 
tilt compensator has the inverse tilt relationship as the 
cable it is equalizing. Tilt compensators have 
symmetrical insertion loss and can be used in either 
direction. 

Tilt compensators have different tilt specifications over 
different frequency bandwidths. Selecting a 
compensator that has a different bandwidth 
specification can provide the value of fixed equalization 
that is desired if the value of cable tilt that you are 
looking for is not a standard value. 


Terminator 

This device is used to prevent reflections of power back 
into the cable system. 


Attenuators 

Attenuators provide a constant attenuation over a wide 
range of frequencies. This attenuation is symmetrical 
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from either end. It does not matter in which direction 
the attenuator is connected. 

Computing Signal Levels and Network 
Attenuation 

This section discusses signal levels in an IBM PC 
Network. The design of the network includes providing 
a signal path between the frequency translator and user 
devices, to ensure adequate signal strength at each 
node. Each layout design drawn on paper can be 
checked for providing proper signal amplitude by taking 
the transmitter output level and subtracting the required 
receiver signal level. The design must achieve nominal 
attenuation values that satisfy the level difference 
requirements between the transmitter and the receiver. 

Signal Level Margins 

This section discusses signal level margins allowed at 
each node. The cause of a signal loss in the network 
and how to account for it is also described. 

The specified values are as follows: 

Adapter input rar^e: -7 to 24 dBmV — operating 

range 

8.5 dBmV — nominal 

61.25 dBmV — maximum 
input without damage. 

Adapter output: 56 dBmV ±4 dB 

56 dBmV — nominal 

Frequency Translator 

input range: 7.25 dBmV to 21.25 dBmV 

14.25 dBmV — nominal 

60 dBmV — maximum input 
without damage. 

Frequency Translator 
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gain: 


36 dB ±4 dB 
36 dB — nominal 


Network 

Attenuation: 


41.75 ±3 dB @ 50.75 MHz 

41.75 ±4.5 dB @ 219 MHz 


Network Attenuation 

Passive loss is the attenuation caused by all the passive 
components in the network. This loss is constant across 
the entire frequency spectrum on the network. Cable 
loss is the attenuation caused by the coaxial cable. 

Cable loss increases with frequency and is called cable 
tilt. The IBM PC Network Medium and Long Distance 
Kits have built-in tilt compensation. Different tilt 
compensation is required for different t 5 q)es and lengths 
of coaxial cable. 

The cable attenuation for the IBM PC Network in the 
forward path (219 MHz) is 1.95 dB per 100 feet and in 
the reverse path (50.75 MHz) is 0.95 dB per 100 feet. 

A 100 foot length of RG-11 U cable has 1.95 dB of 
attenuation at 219 MHz, and 0.95 dB of attenuation at 

50.75 MHz. If you connected an equalizer that had 
0.95 dB of attenuation at 219 MHz, and 1.95 dB at 

50.75 MHz to the length of coax, the resultant 
equalized flat loss would be 2.9 dB from 50.75 MHz 
through 219 MHz. Flat loss in an equalized cable is 
equivalent to passive loss. 

Network balancing consists of adjusting the passive loss 
in the path to each node to obtain signals within the 
acceptance range at the PC Network Adapter receiver 
and at the frequency translator receiver. The loss in a 
path can be adjusted by changing component values, 
cable length, or the distribution structure. 

• Splitters divide power for symmetrical separation. 
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Equalized cable loss transports the signal with a 
minimum of tilt. 


• Attenuators decrease signal level. 

• Directional taps remove a small amount of signal 
power from a signal line and produce a tap signal 
level lower than the supplying line. Taps are rated 
by an attenuation value. 

• Fine tuning of level (changing level by less than 3 
dB) can be accomplished by either changing the 
length of cable or by using precision attenuators. 


Design Procedure 


This section provides a checklist of steps to follow 

when designing a network. 

1. Survey the facility to determine the required 
installation effort, and to identify cable pathways 
and outlet locations. 

2. Determine the physical layout of the cable system. 

3. Mark the cable path on the drawing from the 
frequency translator through the facility to each 
outlet. 

4. Compute or estimate the length of each cable 
segment and calculate the cable loss of each 
segment. 

5. Calculate the signal level delivered to each outlet 
from the frequency translator. Calculate the signal 
level delivered to the frequency translator from the 
farthest node on each branch. 

After completing this design procedure, a design 

consultant can check over your facility and your design. 
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A design review before installation by a qualified 
broadband/ CATV engineer can identify any possible 
problems you might face during installation and use. 


Choosing a Topology 

The first step in any design of a network is to define the 
cable routing topology. If all of the nodes are located 
in clusters, a star topology can be the most appropriate. 
If the nodes are adjacent to a long run, similar to offices 
on each side of a long hallway, a bus topology is most 
appropriate. If uniform outlet distance for a large area 
is required, a tree or multiple bus topology should be 
used. 


Star Topolc^ 

The star topology is the simplest network to design and 
install because the attenuation path is a single line 
between the Translator Unit and the node. This 
topology is made up of mostly cable series attenuation 
and has a straight-forward control on errors. 
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Figure 4-1 Sample Star Layout 

The component tolerances add to provide one simple 
uncertainty. This aspect of the topology simplifies the 
transparent network design requirement. The star 
topology’s main trade off is that it requires large 
amounts of cable to implement a large-scale network. 
For a small-scale network, this can be the most 
cost-effective solution. 
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Example: 


Probl em--Design a network that supports 
two nodes that are two hundred 
feet apart. 

Solution--Locate the Translator Unit in 
the center of the two nodes 
and route a hundred feet of 
RG-ll/U coaxial cable to each 
node. A two-way splitter 
provides the outputs with a 
minimum of error. Place an 
attenuator on each end of the 
splitter and connect the 
cable to the attenuators. 

The design example is the simplest solution to the 
problem. The design does not allow for expansion. 

This network would require redesign when you decide 
to connect additional nodes. If the two-way splitter has 
an insertion loss of 3.5 dB to each output, and the 
coaxial cable has an attenuation of 0.95 dB per 100 feet 
at 50.75MHz (return path) and an attenuation of 1.95 
dB per 100 feet at 219MHz (forward path), the 
attenuation value can be calculated. The IBM PC 
Network devices require a network attenuation of 
41.75 ±3 dB in the return path and an attenuation of 
41.75 ±4.5 dB in the forward path. 

If the attenuation of the splitter, cable and the 
attenuators are within the network specifications, the 
design is acceptable. A quick check of the component 
errors reveals that the splitter has a ±0.25 dB tolerance 
and the tilt of the coaxial cable is 1 .0 dB. The total 
possible component error is less than the required 
network tolerance. The design will work if the nominal 
attenuation of the design example does not introduce 
additional error. 

Solving for the attenuator value, we find that the ideal 
attenuator has 37.30 dB in the return path and 36.30 
dB in the forward path. Since attenuators are passive 
devices the least error would result if the average value 
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of 36.80 dB was used. This would present a problem to 
the designer since the value of 36.80 is not a standard 
value. To make sure that the selected standard value 
attenuator works, perform an error analysis. 

As the standard values of attenuators are 3, 6, 10, and 
20 dB, cascading certain values produce a 36 ± 1 dB 
attenuator. If this value is added to the attenuation of 
the splitter and the cable, the design meets the path 
attenuation by 0.45 dB. You can verify this by adding 
the splitter, cable and attenuators, attenuation, and 
tolerances together and comparing the result to the 
network specification for return path loss. 


Bus Topology 

When the outlet design suggests a bus topology, the 
material cost may be lower than the star topology. The 
bus topology requires only one main feeder cable that 
distributes the proper signal levels to the outlets by 
providing the proper attenuation. 

The bus topology has a slightly different design 
approach than a star approach. The attenuation path to 
an outlet of a bus network can include the insertion loss 
of several devices in cascade. The insertion loss of the 
passive device may have a small dependency on 
frequency. When the passive device is placed in 
cascade, the dependency may accumulate into a large 
path attenuation error. It is very important to select 
parts that have insertion loss information at several 
frequencies. This information reduces the design error 
in the network. 
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Figure 4-2 Sample Bus Layout 

Passive components have tolerance specifications for 
insertion loss, frequency response, and tap attenuation. 
The insertion tolerance can accumulate when placed in 
cascade. When designing a network, it is important to 
control these tolerances. If the network is to be 
implemented from paper to practice and the network is 
not going to be tested for path attenuation at all nodes, 
limit the number of cascaded insertions. If the design is 
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tested in both paths, it can have cumulative insertion 
tolerances that exceed the allowable path attenuation 
error. The network can require field selection of 
components and slight reconfiguration in the field to 
bring the network within specifications. 


Translator 

Unit 



^ Level = 4 — A ± B 

Level = 4 


Where: 

Insertion = A 
Insertion tolerance = ± B 
(0)-^ — — Means a node 


Figure 4-3 Cumulative Insertion Error on a Bus Structure 


Note: Neglect the cable and assume that all taps 
have the same nominal tap attenuation value. 

In the figure, all of the taps have the same insertion 
attenuation of "A", with an insertion tolerance of "B". 
The taps following the first tap have a higher 
attenuation value, due to the cascaded insertions. Also 
note that the figure neglects the cable attenuation. If 
the insertion loss "A" is made smaller, the difference 
between the taps will be smaller. In the cascade shown, 
the center tap has the average attenuation difference 
between the first and the last taps. This assumption is 
good for tap-to-cable insertion attenuation ratios as 
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small as 0.5 : 1. If the average tap is designed to have 
the nominal path attenuation, then a symmetrical error 
occurs in the first and the last taps. 

The previous discussion made the assumption that the 
insertion attenuation "A" was made as small as 
possible. High tap isolation values have the smallest 
insertion losses. Smaller insertion losses introduce less 
cascade error to the next tap of the same isolation 
value. High tap isolation values can only be used when 
large signal levels are fed into the bus. The trade-off of 
this error-control method is poor power utilization. 
Many more nodes can be accommodated when the tap 
isolation range is between 20-30 dB, without incurring 
the large insertion errors of the low isolation directional 
couplers. 

The transition between tap attenuation values can also 
be studied to minimize cascaded error. At the last value 
of tap insertion "A", the attenuation from the nominal 
tap is two insertions and two cable length insertions 
from the input of the next cascade tap attenuation 
value. The advantage of the insertion loss being 
incurred after a tap can help the next 3 dB lower tap 
attenuation value to be closely centered about the 
nominal path attenuation. If the second group of three 
taps has the same insertion attenuation as the first 
group of three taps, the nominal value would fall in the 
middle. If the cable attenuation and the tap insertion 
added up to 1 dB, this method reduces errors. Use this 
method when it is not required to have taps located in 
exact locations. Therefore, if the taps can be made 
location independent, the error accumulated in a bus 
structure can be reduced below the tap selection 
increments of 3 dB. This method, for example, 
recovers 1 dB of error that would have been used in 
permitting taps to be located in any position along the 
bus. 

If the cable length between the taps is held relatively 
constant for a given tap insertion value, the bus can be 
modeled as a repUcating unit that has one cable 
insertion and one tap insertion. This concept allows the 


4-18 Network Desi^ 



replicating units to be cascaded like lamp extension 
cords. The first cascade of three values uses one tap 
attenuation value, while the next cascade of three taps 
uses the next three dB lower tap attenuation value. If 
the insertion loss of the tap increases, the tap spacing 
can be decreased. If the bus requires tilt compensation, 
the structure can be repeated. 

If two groups of three cascaded taps are implemented, 
the nominal levels appear on the second tap of each 
group of three taps. When the cable attenuation 
non-linearities are considered, it may be better to 
design the nominal of the first group of three to have a 
higher return attenuation, and the nominal of the 
second group of three to have a lower forward 
attenuation. If these nominal errors are symmetrical 
around the nominal network attenuation, the lowest 
error approximation can be achieved. Verification of 
these concepts can be time consuming. 

Another method of reducing the insertion attenuation 
effect on cascaded output levels is to increase the tap 
from a one-way to a two-, four-, or eight-way. This 
change does not increase cascaded insertion error. 

These devices use a single insertion tap connected to a 
power splitter, providing more outputs with fewer 
insertions. 

Drop-line cable errors from any feeder cable must be 
taken into account when designing the bus distribution. 
It is best to make all drop cables the same length. 
Minimum drop cable tolerances allow an increase in the 
amount of insertion tolerance permitted. 

If feeder cable tilt error becomes too large to 
accommodate, tilt compensation is required. Periodic 
spacing results in the least amount of nominal 
attenuation error to the outlets. Normally an 
uncompensated bus has too little attenuation in the 
return path and too much attenuation in the forward 
path . When tilt compensators are used in a distribution 
bus, it is possible to over compensate the bus. This 
requires that the return path be checked for over 
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attenuation and the forward path be checked for under 
attenuation. This is in addition to the two conditions 
mentioned for uncompensated bus topologies. 

If tilt compensation is required in a cable layout, it is 
easier to compensate a branch than it is a feeder Une. 
Branches are used to distribute signal power to the 
feeders. This is analogous to a highway, providing 
access to individual neighborhoods. The highway is the 
branch, the neighborhood street is the feeder, the 
driveway is the drop lines, and the garage is the node 
(outlet) of the network. 

A tree topology allows the functional separation of 
responsibilities. The branch divides the signal power 
among the feeder cables, and the feeder cables 
distribute that power to the outlets. An example of a 
tree topology is a two-way splitter that branches into 
two bus feeder lines. The branch can resemble a small 
feeder bus, except that its outputs branch into other bus 
topology feeder lines. The branch is a logical extension 
of the bus design discussed previously. 


Extended Coverage 

The limiting factors in extending the range of the 
network are the cable attenuation in the forward path, 
equaUzation limitations of the fixed equalizers, and 
tolerances of the component values. The difference in 
cable attenuation does not cause a problem when using 
the IBM kits, because the longest cable run possible is 
1000 feet from translator to adapter. 

Rigid aluminum low-loss cable or amplifiers would have 
to be used. Both of these alternatives are beyond the 
scope of this book. 

When designing cable networks, include expansion into 
the design. The simplest way to expand the network is 
to design unused splitters or taps into the branches. 
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Future Needs 


This section contains some notes on planning for future 
expansion of your network, including extending the 
coverage to add new nodes and connection to other 
networks. 


Adding Outlets to the System 

The easiest way to expand an existing network is by 
connecting new Personal Computers to existing nodes 
that were designed into the network and left idle. It is 
best to design your system with expansion in mind. 

One of the most common techniques used to design for 
expansion is to leave idle taps on every multi-tap in the 
system. When four taps on every eight-port tap are left 
idle, the network has a 100% expansion capability. 

In some areas covered by the network, you should leave 
room for more expansion if multiple services are to be 
added in the future. Incorporating video or voice into a 
network can lead to a need for two or three taps in each 
office requiring such services. For most small office 
applications, planning for one tap for each desk in the 
facility plus some extra taps, should satisfy most 
requirements. 


Adding Branches to the System 

For networks that require major expansion, outlets 
might not provide enough connectivity. For such 
networks, splitters can be inserted into the signal path 
where a major branch might be required in the future. 
One leg of the splitter could be terminated for that 
future need. The other leg of the splitter feeds the 
existing network. Computing signal levels properly for 
this portion of the network allows you to add entire 
branches with many branches and nodes of their own. 
Then a new portion can be designed, installed, tested 
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separately, and attached to the main network at the 
reserved expansion leg of the splitter. This is the type 
of implementation used in the IBM PC Network. 


Test Equipment 

This section lists the basic items of test equipment that 
can be used to check out the passive network functions. 
The two items covered here are the RF sweep generator 
and the RF voltmeter. 


RF Sweep Generator 

This type of generator produces signals of the proper 
frequency and amplitude for transport over the 
network. Transmitting a fixed-frequency and 
fixed-amplitude carrier signal over the cable allows you 
to check no m inal attenuation levels in the forward and 
reverse paths. When the sweep generator is used in the 
sweep mode, it can locate either compressed cables or 
loose connections that are causing frequency response 
irregularities. 

The generator’s frequency range may be set to either 
the forward or reverse bandpass, depending on its 
location either at the translator or at the outlets. Its 
amplitude is also set depending on whether it feeds the 
network, or whether it feeds the outlets. 

Set the sweep generator to sweep the forward 
frequencies at the translator unit location. At this 
location, the generator supplies signals that can be used 
to test each outlet on the network. The generator can 
normally be set to supply the same level as the 
translator, so that the level at the outlets are the same 
as the network device. The generator can also be 
connected to any outlet in the network. In this case it 
should be set to the reverse frequency band. It should 
transmit at the same level as the devices connected to 
the network. 
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RF Sweep Receiver 

The device that monitors the sweep generator output is 
the sweep receiver. This device is normally controlled 
automatically (range, frequency) by the sweep 
generator. Investigate any discontinuities or excessive 
losses at any frequencies in the band to ensure that they 
are not causing degraded network performance. 

This type of receiver allows reception of sweep 
generator signals and analysis of network path 
attenuation for a predetermined range of frequencies. 


RF Voltmeter 

The RF voltmeter or field strength meter (FSM) is a 
popular test instrument. It measures the amplitude of 
an RF signal at a specific frequency. This device is easy 
to operate and can be used for measuring signal levels, 
verifying signals, and troubleshooting. The output 
meter is calibrated in dBmV. Connection to the 
network is made through an RF cable directly to an 
outlet or tap port. The frequency is selected by setting 
the appropriate tuning dials or by entering numbers on 
a keypad, and the signal level is read on an analog or 
digital meter. Some RF voltmeters also have built-in dc 
voltmeters. 


The following list covers typical specifications for an 
RF voltmeter. 


Amplitude -40 dBmV to 4-60 dBmV 
Frequency 4 to 460 MHz 

Temperature 0 to 120 degrees F 

Accuracy: 


Frequency ±100 kHz to ± 1 MHz 
Amplitude ±0.5 dB at 68 degrees F, 
± 1 dB over full frequency 
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range 


DC 


Voltage ±10%. 


IF Bandwidth 

Power 

Calibration 


280 kHz to 600 kHz 

Battery 

Built-in 


More Specialized Equipment 

An RF radiation monitor measures RF energy radiated 
by equipment or components of the network. This 
instrument pinpoints areas where the system radiates 
RF energy, most often through a poor connection, a 
corroded connector, or a damaged cable. When 
radiation occurs, you can assume that the system is 
more susceptible to signal ingress. Signal ingress could 
hinder the proper operation of the network. 

The cable reflectometer is used in locating cable faults 
caused by physical breaks, bends, or kinks in a given 
span of cable. This instrument can indicate the location 
of the fault to within a few feet. Cable system 
troubleshooting time is minimized by the combined use 
of a reflectometer and accurate, scaled drawings of the 
cable layout. 


Checking a Network 


The following uses the IBM PC Network as an example 
on how to check a network. RF signal levels can be 
checked at each outlet to ensure that the distribution 
system is working as desired. This checkout can be 
done with a sweep generator and a sweep receiver. 
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Where to Check 


If a known working Personal Computer with adapter 
does not work when it is connected to a suspected 
outlet, check the outlet. Also check the outlet if the 
Personal Computer obviously works only marginally 
(that is, much lower throughput or slower response 
from the network when sending data to other nodes, 
compared to the performance when it is connected 
elsewhere.) 


When to Check 

• When first installing the network, check signal 
levels at all or selected outlets. Ensure that every 
branch can carry RF signals. 

• Check the network whenever a problem is 
suspected, such as when a noticeable performance 
degradation occurs, and the computer checks out 
OK otherwise. 


How to Check 

Method 1 : Forward Path Test 

This puts the generator at the translator unit location 
and can check that each adapter receives the proper 
signal level. 

1. Remove the network’s RF cable from the 
translator and connect a 9 dB directional coupler 
(RMS CA-1090-M or equivalent) as shown in 
Figure 4-4 on page 4-26. 

2. Set the generator to sweep frequencies from 150 to 
300 MHz. Set the generator for an amplitude of 
60 dBmV. 
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3. If required, set the notch filters on the sweep 
transmitter to sweep around channels T-14 and J. 
This will ensure non-interference with other 
network channels. 

4. Connect the sweep receiver to outlets and monitor 
the sweep. The network attenuation is equal to the 
signal generator level minus the sweep receiver 
level. Forward network attenuation specification is 
41.75 ±4.5 dB. Remember to test for this forward 
attenuation on a flat portion of the spectrum near 
channel! (219 ± 3 MHz). Also, remember to 
add additional network attenuation of 9 dB from 
the test tap. 

Note: The network attenuation used in this 
example corresponds to the attenuation used in the 
IBM Translator Unit and the cable kits 


IBM Translator Unit 


! 1 



O = Outlet 


Figure 4-4 Forward Path Attenuation Test 
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Method 2: Return Path Test 


This puts the generator at an outlet in the network, and 
tests the IBM Translator Unit on both the forward and 
reverse paths of the cable system. You can check that 
each adapter receives the proper signal level. 

1 . Connect the sweep receiver at the -9 dB sweep 
coupler. 

2. Remember to notch out channels T- 14 or a 
degradation in performance can result for the 
duration of the test. 

Note: Performing this test on an active 
network may have adverse affects on 
performance and could cause system errors in 
some Personal Computer’s. Consider 
performing this test when the network usage is 
low. 

3. Program the return parameters into the sweep 
generator. Set the sweep to cover a 5 to 116 MHz 
frequency range at a 60 dBmV level. The return 
attenuation should be measured near a flat portion 
of the frequency spectrum near channel T-14. The 
network attenuation is 41.75 dB ±3 dB for the 
return path. Remember to take the additional 9 dB 
of attenuation into account when measuring 
network attenuation. 

4. When the test is complete, remove the -9 dB 
coupler. 

Note: The network attenuation used in this 
example corresponds to the attenuation used in the 
IBM Translator Unit and the cable kits 
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Method 3: Walk-through Test 

This procedure is useful for isolating a trouble spot. 

1 . Set up the sweep generator for a continuous wave 
(C W) single frequency at the Translator Unit 
location. Couple the generator through the 9 dB 
coupler as described in the forward path sweep 
test. The frequency should be in the forward path 
near channel J. An example frequency would be 
225 MHz at an amplitude of 60 dBmV. 

2. Set the RF voltmeter to its highest amplitude scale 
and set the frequency to the same frequency 
setting as the C W frequency set on the sweep 
generator. 

Note: When the sweep transmitter is in C W 
mode, only one frequency is transmitted over 
the network. A presence of this frequency 
can quickly determine an open, short, or a 
poor connection. 

3. Take the RF voltmeter and a copy of your system 
drawing to the sphtter in question, and check 
which nodes are working. This is accomplished by 
lowering the scale on the meter until a reading can 
be obtained. If you find a node without a signal, 
check at least one or two surrounding nodes. 
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4. Test the signal into the sphtter. 


IBM Translator Unit 



O = Outlet 


Figure 4-5 Splitter Test 
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5. If no signal is present, test for a signal into the 
cable going to the splitter. If a signal is present, 
the last part tested is not working properly. 


IBM Translator Unit 



O = Outlet 


Figure 4-6 Cable Test 
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6. If no signal is present, test for a signal into the 
cable going to the Base Expander. 


IBM Translator Unit 


1 



O = Outlet 


Figure 4-7 Base Expander Test 


7. If no signal is present, test for a signal from the 
directional coupler. 


What to Look for when Testing 

Look for widely-varying signal levels between nearby 
outlets, signal levels outside the specified range, and 
extreme variations in signal levels from expected values 
(a map of the system with expected levels recorded 
when the system was working properly is desirable). 

Also, check the following for any other problems; 
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Cut cables 


• Loose or corroded connectors 

• Shorted cables 

• Unterminated trunk lines 

What Can Be Changed if a Problem Is Found 

Change cables after isolating the problem. 

Change connectors or passive components. 

Change the adapter (most RF problems with the 
adapter would be found by the self -test). 

Change the translator if it is not working. 
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appendix B. IBM PC Network 
Specifications 


This appendix is a list of specifications for the IBM PC 
Network hardware; 


Environmental Specifications 

The following lists the environmental specifications of 
the IBM PC Network adapter and the IBM Translator 
Unit. 


Temperature 


Humidity 


Altitude 


The operating temperature range is 
from 10 to 35°C, (50 to 91 °F) 
ambient. The storage temperature 
range is from -40 to 60°C, (-40 to 
140°F). 

The operating humidity range is from 
8% to 80% non-condensing. The 
storage humidity range is from 5% 
to 100% non-condensing. 

The operating altitude is from -305 
to 2135 meters, (-1000 to 7,000 
feet). 
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IBM PC Network Adapter Specifications 

This section summarizes the basic specifications of the 
adapter. 


Electrical Power Requirements 

The specifications for the power requirements of the 
adapter from the three power supplies are as follows: 


Voltage 

Tolerance 

Ripple 

Total 

Current Used 

+ 12.0V 

±5% 

100 mV pp 

0.36 A 

+5.0V 

±5% 

100 mV pp 

1.40 A 

-12.0V 

±10% 

100 mV pp 

0.03 A 
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Adapter RF Modem Specifications 

The following is a list of the specifications for the RF 
modem on the adapter. See “RF Modem Section” on 
page 3-50 for a complete list of specifications for the 
RF modem section. 


Input/ output impedance 

75 ohms typical 

Return loss: 


- With power ON (T-14, J) 

- With power OFF (T-14) 

- With power OFF (J) 

> 14 dB 

> 14 dB 

> 8dB 

Transmit channel 

T-14 (50.75 

MHz) 

Modulation technique 

Frequency shift 
keying (FSK) 

Frequency shift 

±2 MHz ±200 
kHz centered 
about 50.75 MHz. 

Transmit output level (ON) 

56dBmV ±4dB 

Transmit output level (OFF) 

< -20 dBmV 

Receive channel 

J (219.0 MHz) 

Receive bandwidth 

3.6 MHz 
(nominal) 

Receiver Input level 

8.5 dBmV 

Input level range 

-7 dBmV to 24 
dBmV 

Maximum input level 

61.25 dBmV 
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• Carrier detect threshold -20 to -8 dBmV 

• Maximum number of adapters 1000 
supported 

• Maximum distance supported Up to 5 kilometers 

with the proper 
network design. 
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Network Cable Characteristics 


The IBM PC Network hardware communicates on a 
75 -ohm coaxial cable network. This section defines the 
characteristics of that network. 


• Input/output impedance 75 ohms typical 

• Tap reflection coefficient > 14 dB 

(from 10 to 350 MHz) 

• Transport echo delayed more -30 dB maximum 
than 25 ns. 

• Port ac-dc power Blocked 

characteristic 

• Transport channel (6 MHz) 2 dB 
flatness (peak to valley) 


• Transport phase delay in ±25 ns < 100 jus 

channels T-14 and J, 

round trip: 

• Transport second order -56 dBC max 

intermodulation (Note 1) 

distortion 


• Transport third order distortion -56 dBC 
maximum (Note 1) composite 


• Forward carrier-to-noise ratio 53 dB minimum 
(Note 2) 

• Reverse carrier-to-noise ratio 53 dB minimum 
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Transport carrier-to-hum ratio 40 dB minimum 


• Transport Transfer Characteristics (Includes cable 
and tap); 

The output level variation over nominal system loss in 
the return path must be within ± 3 dB of the input 
level. The forward path must be within ±4.5 dB of 
the input level. Both specifications apply to the 
corresponding system channel. 


• Forward noise floor in channel J < -24 dBmV 
with all transmitters OFF at worst (Note 2) 
case mode: 


Note: 1) Referred to available forward tap level. 

Note: 2) For a network having a 47.5 dB nominal 
network attenuation from the adapter transmitter 
to the adapter receiver and having 1000 adapters 
on the network. 
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IBM Translator Unit Specifications 

This section defines the electrical specifications of the 
Translator Unit. 


Electrical Specifications 


• Input/ output impedance 7 5 ohm typical 

• Trunk feed levels (typical) 


- Forward 

- Return 


+ 50.25 dBmV 
+ 14.25 dBmV 


• Trunk feed return loss 14 dB minimum 

• Reflection coefficient 4 MHz minimum 

bandwidth 

• Channel Allocation 


- Input center frequency 50.75 MHz 

- Output center frequency 219 MHz 

- Channel bandwidth 6 MHz 


• Input (receive) characteristics 

- Minimum input level 7.25 dBmV 

- Maximum input level 21.25 dBmV 


- Selectivity 

3dB bandwidth > 5 mHz 

3 OdB bandwidth <24 MHz 

- The maximum sustained 60 dBmV 

input level without 

damage 
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Output characteristics 


- Maximum carrier output 
level 

• Translator oscillator frequency 
characteristics 

- Long term stability 
(until the end of 
life over environ- 
mental range) 

- Center frequency 
accuracy 

- Spurious level at 

6 MHz from carrier 

• Translation characteristics 

- Nominal loop gain 

- Loop gain setting 
accuracy 

- Gain variation until 
end of life and over 
environmental range 

- Pass-band bandwidth 

- In band level ripple 
(peak to valley) 

- Group delay 

- Phase delay 


61.25 dBmV 

± 80 ppm 

±11.7 kHz 

-40 dBC 

36 dB 
±ldB 

±3 dB 

±3 MHz 
1.5 dB 

± 25 ns max. 
200 ns 
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47 dB min. 


- Carrier to noise ratio 
(at typical carrier 
output level, with the 
specified signal source 
at the input) 

- Noise figure (for 
rated loop gain) 

Maximum adapters supported 
by the Translator Unit: 

- Pass-band spurious 
level 

(referred to maximum 
carrier output, with 
the specified signal 
source at the input) 

- Carrier to hum ratio 
Power supply requirements 

- Line voltage variation 


- Power consumption max 


9dB 

256 

-40 dBC max 

40 dB min 

14.5-23.4 Vac 
RMS 

1 1 watts 
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Physical and Mechanical Characteristics 


• RF Connectors; type F (female) 

(The F connector is 
grounded through 
the AC transformer) 

• Physical dimensions 256.5 x 158.8 x 44.5 mm 

10.1 X 6.3 X 1.8 in. 
(Lx W X H) 
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Appendix C. IBM PC Network Protocols 


This appendix provides information about the IBM PC 
Network protocols.^ The following list describes the 
formats of the packets that are carried by the network 
in response to command requests. 

Note: The information provided here is for 
reference only. Specific details may vary slightly 
from the actual implementation. 


Purpose of the Protocols 

Personal Computers can exchange data with each other 
using the communication services provided by the IBM 
PC Network Adapters. These adapters accomplish 
communication functions through the implementation 
of a common set of protocols. 

• Protocols are rules to govern communication over 
the network. These rules include such functions as 
data transmission, reception, and acknowledgment 
over the cable. 

• Protocols are needed because multiple computers 
share a common cable medium. The computers 
must communicate with each other over the cable 
medium reliably without interference from one 
another. The protocols aid in reliable 
communications, provide addressing for all 
computers on the network, and control the flow of 
data traveling to other computers on the network. 

• These common protocol functions are available to 
all computers on the network. 


1 Copyright of Sytek, Inc. and the IBM Corp. 
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To be compatible with the network, all computers must 
follow the PC Network protocol procedures and must 
understand the protocol formats. 


Hierarchical Implementation of Protocols 

An implementation of the PC Network protocols can 
be modularly structured in a hierarchical fashion. 
Compatibility between nodes does not require that the 
internal implementation of the adapter protocols within 
each nodes be identically structured. It is only required 
that they follow the same procedures and protocol 
formats. 

Within the adapter, the software implementation of the 
protocols are hierarchically organized according to the 
specific protocol function. 

• The adapter’s protocol implementation comprises 
five separate layers of protocol modules. 

• Software is arranged in a hierarchy of protocol 
layers. Each layer communicates with one layer 
above and one layer below it. Each layer provides 
specific services to the other layers. 

• Layered structure allows easy development and 
change of the protocol software, and clear 
straightforward communication with other devices 
on the cable. 

• The lowest layer is the hardware that transmits and 
receives signals over the cable. It converts the 
digital data to analog signals for transmission over 
the cable, and receives analog signals and converts 
them to digital data for use by the adapter. 

• The highest layer communicates with the software 
resident in the host computer. The layer conveys 
the necessary data to the user application program. 

• Data transmission process is as follows: 
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- The top layer of the adapter’s protocol 
software receives data to be sent over the 
network from the host computer’s interface 
software. 

- Each layer of the protocol software adds 
control information to the data it receives 
from the next higher layer, and passes this 
data packet down to the next lower layer. 

- The packet that is transmitted over the cable 
has the original data, and all of the specific 
control information to be interpreted by the 
receiving adapter’s protocol software. 

• Data Reception Process; 

- The bottom layer of the adapter’s protocol 
implementation receives a signal from the 
network’s cable. 

- This layer converts the incoming analog signal 
into digital data, and passes this data to the 
next higher layer of the protocol. 

- Each layer of the protocol software in the 
adapter reads and interprets control 
information inserted by the corresponding 
layer of the transmitting unit. Each layer then 
passes the contents of its data packet up to the 
next higher layer. 

- The top layer delivers the original data to a 
layer of communication software in the host 
computer. This data in turn will correspond to 
the user which sent the data from the 
originating computer. 

The following is a list of the IBM PC Network adapter 

protocols under the appropriate layers; 

• Link Layer 
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Link Access Protocol (LAP)^ — provides basic 
CSMA/ CD, packet framing, addressing, and error 
detection services. LAP is responsible for the 
exchange of data frames between two nodes. LAP 
is used to provide service for the Packet Transfer 
Protocol (PTP)2. 

• Network Layer 

Packet Transfer Protocol (PTP)2 — provides 
routing, address discovery, and unacknowledged 
packet transfer services. PTP is used by the 
Reliable Stream Protocol (RSP)^ and Datagram 
Transport Protocol (DTP)^. 

• Transport Layer 

Reliable Stream Protocol (RSP)^ — provides 
error-free virtual connection services to other users 
through end-to-end acknowledgements and 
retransmissions. RSP provides transport layer 
services to the Session Management Protocol 
(SMP)2. 

Datagram Transport Protocol (DTP)^ — provides 
unacknowledged datagram services between 
session layer entities, including the User Datagram 
Protocol (UDP)2 and the Diagnostic and 
Monitoring Protocol (DMP)^. 

• Session Layer 

Session Management Protocol (SMP)2 — provides 
support for user sessions between nodes. SMP 
allows users to establish connection to a named 
process (names) and is responsible for interacting 
with the Name Management Protocol (NMP)^ 
within the local node to determine the address of 
the named process. Once the destination node 


2 Copyright of Sytek, Inc. 
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address is determined, the initiating SMP can 
communicate with the SMP within the destination 
node to provide session level services to both users. 

User Datagram Protocol (UDP)^ — provides 
support for user datagrams between nodes. UDP 
allows users to send datagrams to a named process 
(alias) and is responsible for interacting with the 
NMP within the local node to determine the 
address of the named process. Once the 
destination node address is determined, the 
initiating UDP can exchange datagrams with the 
UDP within the destination node. 

Name Management Protocol (NMP)i — provides 
the binding of alias names and network addresses 
within the entire local network. NMP provides all 
name management services, including the 
translation of remote names to network addresses, 
to both SMP and UDP. 

Diagnostic and Monitoring Protocol 
(DMP)i — provides protocol mechanisms that 
allow the collection of diagnostic and status 
information, and provides support for other 
network management functions. 

SMP, UDP, NMP, and DMP services are 
accessible to the Host Interface Process. 

The relationship between the various protocol services 
is shown in the following illustration. 
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Figure C-1 Relationship Between the Various Protocol Services 
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General timing of packet exchanges 


The following three sections describe the packet 
exchange interactions for session establishment, data 
transfer, and session termination. 


Session Establishment 

The session initiator sends an Open Request to the 
responder who returns an Open Ack. The initiator then 
sends a Session request that is followed by a Session 
Accept or Session Reject. 


Session Establish 


Initiator 


Responder 


— > 

Open Request 

> 

< — 

Open Ack 

< 

— > 

Session Request 

> 

< — 

Session Accept or Reject 

< 
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Data Transfer 

Both sides of a session exchange Data and Ack / Nack 
packets during a session’s lifetime. Data packets have 
increasing sequence numbers, and are retransmitted if 
not acknowledged. Ack / Nack packets may request 
retransmission of specific packets. Data packets always 
have the same sequence number when retransmitted. 



Data Transfer 
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Responder 
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Data 
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< — 
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< — 

— > 

Data 
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Session Termination 


Either side of a session can initiate termination. This is 
accomplished through an exchange of specific Ack / 
Nack, Close, and Closed messages. 


Session Termination 
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Close 
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Close 

— > 
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Packet Processing 

This section describes the processing performed by the 
IBM PC Network adapter. These actions are described 
by pseudo code listings of processing initiated by the 
host commands, by processing that is initiated by timer 
expirations, and by processing initiated by received 
packets. 

The following basic internal mechanisms of the adapter 
are required for the processing of the adapter protocols: 

• The name table in the local adapter is the table that 
contains the names that are currently being 
supported by the local node. Names are added to 
the table upon successful completion of an ADD 
NAME or ADD GROUP NAME command. 

Names are removed upon successful completion of 
a DELETE NAME command. The user can refer 
to a current entry within the local name table by 
using the name number (NAME NUM). 

• Several types of packets within the adapter 
protocols must be retransmitted if a timely 
response is not received. Each such transmitted 
packet will have an associated timer and a counter. 
The timer starts when a packet is transmitted. 

When expiration time for a timer is reached, the 
packet will be retransmitted provided that the 
maximum number of transmissions has not been 
reached. The maximum number of transmissions is 
a system parameter known as “maxRetransmit”. 

• Each node on the network is assigned a unique 
identifier known by its permanent node name. In 
the following protocol descriptions, the permanent 
node name of the local node is simply referred to 
as the “local node name”. 

• Packets can be directed specifically to a node by 
using the permanent node name. The packets can 
also be directed to a group of nodes by using a 
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group address. Group addresses are derived from 
a 16-byte name by using the function (f) defined 
as follows: 


f(name) = 0000. (N1 XOR N2 . . . N5 XOR N6).FF 


Where: 

N1 . . . N5 are the first through the fifth 
3 byte fields which make up the 
name, and N6 is the last byte of 
the name concatenated with two 
bytes of zeros. 

XOR represents a logical exclusive 
or operation. 

The period (.) represents the 
concatenation operation. 


Group addresses are also derived from the permanent 
node name by using the function (g) as follows: 


g(permanent node name) = 0000.(103 ID2 IDD.FF 


Where: 

103 . . . IDl are the three low-order bytes 
of the permanent node name. 

The period (.) represents the 
concatenation operation. 


The adapter processing can be described in an event 
driven manner where the three types of events are as 
follows: 

1. Receipt of a command block from the host. 
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Such events are processed by using command specific 
procedures which are identified below as 

“PROCEDURE command type (command block)”. 

Command type is the name of the specific type of 

command, and the command block includes all the 

parameters associated with the command as it is passed 
from the host to the adapter. 

Also note that “return ... to user” indicates the return 
of a completion of the processing associated with that 
command. Although certain fields within a returned 
command block can be inspected and used to provide 
the necessary information to the user, it does not 
indicate that there will be no further adapter activity 
associated with the processing of that command. 

2. Expiration of the timers. 

Such timer activity is always associated with a specific 
prior packet transmission and the action taken by the 
adapter in response to such timer activity depends on 
the original associated packet type. 

3. Reception of a packet. 

The processing performed by the adapter depends on 
the type of packet received as well as the values of 
specific control fields within the packet. 

The next section describes the adapter processing for 
each of the above mentioned types of events. 
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Pseudo Code for NCB Commands 


RESET 


PROCEDURE Reset (command block); 

{set configuration parameters} 

BEGIN 

IF either of the two configuration 
parameters are equal to zero THEN; 
set configuration parameters to default values 
{6 sessions, and 12 commands} 

ELSE 

BEGIN 

set configuration parameters in configuration table; 

return command completed status to user; 

END 

END; 
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STATUS 


PROCEDURE Status (command block); 

{get LANA configuration parameters and status} 

BEGIN 

IF buffer length is illegal THEN; 

return illegal buffer length status to user; 

ELSE 

IF name in conflict THEN; 

return name conflict status to user; 

ELSE IF name is local name or name is * THEN; 

BEGIN 

get configuration parameters and status of local LANA; 
return configuration parameters and status; 
return actual length of configuration 
parameter and status; 

IF size of user buffer is smaller than the configuration 
parameter and status THEN; 
return message incomplete status to user; 

ELSE 

return command completed status to user; 

END 

ELSE 

BEGIN 

send status request packet to remote node; 

wait for response from remote node; 

{remote node send status response packet} 

IF status response packet is received within the timeout 

interval THEN; 

BEGIN 

extract configuration parameters and 
status of remote LANA; 
return configuration parameters and status; 
return actual length of configuration 
parameter and status; 

IF size of user buffer is smaller than the configuration 
parameter and status THEN; 
return message incomplete status to user; 

ELSE 

return command completed status to user; 
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END 

ELSE 

return command timed out status to user; 

END 

END; 
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ADD NAME 


PROCEDURE Add Name (command block); 

{request local registration of name} 

BEGIN 

IF name begins with * or null THEN ; 

return illegal name status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name is found THEN; 

BEGIN 

IF name in conflict THEN ; 

return name conflict status to user; 

ELSE 

return existing name number to user; 

return duplicate name status to user; 

END 

ELSE 

IF local name table is full THEN; 

return name table full status to user; 

ELSE 

BEGIN 

REPEAT 

BEGIN 

broadcast name claim packet to network; 

wait for response from remote node in network; 

{all remote nodes search for name in their 

local name tables and send name claim response 

packet if found} 

END 

UNTIL name claim response packet is received 

or number of times to broadcast is reached; 

IF name claim response packet is not 

received THEN ; 

BEGIN 

enter name to local name table; 

return name number to user; 

return command completed status to user; 

END 
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ELSE 

return name in use status to user; 

END 

END 

END; 
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ADD GROUP NAME 


PROCEDURE Add Group Name (command block); 

{request local registration of name} 

BEGIN 

IF name begins with * or null THEN; 

return illegal name status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name is found THEN; 

BEGIN 

IF name in conflict THEN; 

return name conflict status to user; 

ELSE 

return existing name number to user; 

return duplicate name status to user; 

END 

ELSE 

IF local name table is full THEN; 

return name table full status to user; 

ELSE 

BEGIN 

REPEAT 

BEGIN 

broadcast add group name claim 

packet to network; 

wait for response from remote node in network; 

{all remote nodes search for name in their 

local name tables and send name claim response 

packet if found} 

END 

UNTIL name claim response packet is received or 

number of times to broadcast is reached; 

IF name claim response packet is not 

received THEN; 

BEGIN 

enter name to local name table; 

return name no to user; 

return command completed status to user; 
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END 

ELSE 

return name in_ use status to user; 

END 

END 

END; 
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DELETE NAME 


PROCEDURE Delete Name (command block); 

{request local de-registration of name} 

BEGIN 

IF name begins with * or null THEN; 

return illegal name status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name is found THEN; 

BEGIN 

check for pending non active session commands; 
IF non active session command is found THEN; 

terminate the non active session command; 
check the session count in table entry; 

IF session count is zero THEN ; 

BEGIN 

remove name from local name table; 

return command complete status to user; 

END 

ELSE 

BEGIN 

change status of name to de-registered; 

{name will be removed from local name 
table when session count reaches zero} 

return command completed name has 

active session status to user; 

END 

END 

ELSE 

return illegal name status to user; 

END 

END; 


C-20 Protocols 



CALL 


PROCEDURE Call (command block); 

{open user session with remote name using name supplied} 
BEGIN 

IF local resource is not available THEN ; 

return no resource available status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name is not found THEN; 

return illegal name status to user; 

ELSE 

IF name is marked “conflict detected” THEN; 

return name conflict detected status to user; 

ELSE 

IF local session table is full THEN; 

return local session table full status to user; 

ELSE 

BEGIN 

search for remote name in local name table; 

BEGIN 

REPEAT 

BEGIN 

IF name is not found THEN 

broadcast name query packet to network; 

ELSE loop back name query packet; 
wait for response from remote node or 
timeout; 

{all remote nodes search for name 
in their local name tables and send 

name query response packet if found} 

END 

UNTIL name query response packet is received 

or number of times to broadcast is 
reached; 

IF name query response packet is not 

received THEN ; 

return unknown remote name status to user; 

END 
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BEGIN 

send session request packet to destination 

node; 

{destination node search for pending 
LISTEN command, if found, return 

session accept packet, else, return 

session reject packet} 

IF network error THEN; 

return “session aborted” to user; 

IF response from destination is received 
within the timeout interval THEN; 

CASE response OF 

session accept packet: 

BEGIN 

set session established indicator 

in session table; 

return local session number 

to user; 

return command completed status 

to user; 

END 

{session established} 

session reject packet: 

return session open rejected status 

to user; 

END {case} 

ELSE 

return command timed out status to user; 

END 

END 

END 

END; 
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LISTEN 


PROCEDURE Listen (command block); 

{open user session with remote name, using 
name supplied} 

BEGIN 

IF local resource is not available THEN ; 

return no resource available status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name is not found THEN; 

return illegal name status to user; 

ELSE 

IF name is marked “conflict detected” THEN 
return “name conflict detected” status to user; 

ELSE 

IF local session table is full THEN; 

return local session table full status to user; 

ELSE 

BEGIN 

REPEAT 

BEGIN 

wait for session request packet 

or name conflict detection; 

IF LISTEN specific is specified THEN; 

check source of session request packet; 

IF source of session request pack is 

same as remote name THEN; 

set session request completed indicator; 

{LISTEN specific satisfied} 

ELSE 

reset session request completed 

indicator; 

{LISTEN not satisfied, continue 
to wait} 

ELSE 

IF LISTEN any specified THEN 

set session request completed indicator; 

{LISTEN ANY satisfied} 
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END 

UNTIL session request completed indicator is set 

or name^ conflict detected; 

IF name ^conflict detected for outstanding 

LISTEN THEN 
ELSE IF network error THEN; 

return “session aborted” status to user; 

ELSE 

send session accept packet to source; 

wait for first packet on session; 

set session established 

indicator in session table; 

return source of session request packet to user; 

return local session number to user; 

return command completed status to user; 

{session established} 

END 

END 

END; 
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HANG UP 


PROCEDURE Hang Up (command block); 

{close user session indicated by 

local session number } 

BEGIN 

IF local session number is illegal THEN; 

return illegal session number status to user; 

ELSE 

IF session is already closed and session closed status has 

not been reported THEN; 

return session closed status to user; 

ELSE 

IF session is already aborted and session aborted 

status has not been reported THEN; 

return session aborted status to user; 

ELSE 

BEGIN 

REPEAT 

IF a RECEIVE command is pending THEN; 
terminate RECEIVE command with a 

session closed status to user; 

UNTIL all pending RECEIVE commands 
are terminated; 

REPEAT 

IF a SEND or CHAIN SEND command 
is pending THEN ; 

wait until the SEND, CHAIN SEND, or 
HANG UP has completed or 
timed out; 

IF the SEND command was timed out THEN 
abort the session; 

UNTIL all pending SEND and CHAIN SEND 
commands are completed or timed out; 
send close packet to destination node; 
wait for close packet from destination node or 
close timeout; 

{destination node close the session 
and send close packet} 

IF close packet is received before the close 
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timeout interval THEN; 

BEGIN 

close the session; 

return command completed status to user; 

END 

ELSE 

BEGIN 

abort the session; 

return session aborted status to user; 

END 

IF RECEIVE to name command is pending THEN; 
terminate RECEIVE to name command with 

session closed or session aborted status; 

ELSE 

IF a RECEIVE ANY or to any name command 
is pending THEN 

Terminate the RECEIVE ANY command 
with session closed or session 
aborted status; 

END 

END; 
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SEND 


PROCEDURE Send (command block); 

{send data through user session as indicated by 

local session number} 

BEGIN 

IF local session number is illegal THEN ; 

return illegal local session number 

status to user; 

ELSE 

IF session is closed and session closed status has not 

been reported THEN; 

return session closed status to user; 

ELSE 

IF session is aborted and session aborted status has 

not been reported THEN; 

return session aborted status to user; 

ELSE 

BEGIN 

send session data packet(s) to destination node; 
wait for ack packet(s) from destination node 
or for timeout; 

IF session data is sent successfully within the 
timeout interval for session send THEN; 

return command completed status to user; 

ELSE 

BEGIN 

abort the session; 

return command timed out status to user; 

END 

END 

END; 
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CHAIN SEND 


PROCEDURE Chain Send (command block); 

{send data through user session as indicated by 

local session number} 

BEGIN 

IF local session number is illegal THEN; 

return illegal local session number status to user; 

ELSE 

IF session is closed and session closed status 

has not been reported THEN; 

return session closed status to user; 

ELSE 

IF session is aborted and session aborted 

status has not been reported THEN ; 

return session aborted status to user; 

ELSE 

BEGIN 

send session data packet(s) to destination node; 
wait for ack packet(s) from destination node 
or for timeout; 

IF session data is sent successfully within the 
timeout interval for session send THEN; 

return command completed status to user; 

ELSE 

BEGIN 

abort the session; 

return command timed out status to user; 

END 

END 

END; 
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RECEIVE 


PROCEDURE Receive (command block); 

{receive data through user session as indicated by 

local session number} 

BEGIN 

IE local session number is illegal THEN; 

return illegal local session number 

status to user; 

ELSE 

IF session is closed and session closed status has not 

been reported THEN ; 

return session closed status to user; 

ELSE 

IF session is aborted and session aborted status has 

not been reported THEN ; 

return session aborted status to user; 

ELSE 

BEGIN 

wait for session message (data packet(s)) 
from source node; 

IF session data is received within the timeout 
interval for session receive THEN; 

BEGIN 

send ack packets(s) to source node; 
transfer session data to user buffer 
of appropriate length; 
return actual length of transfer to user; 

IF size of user buffer is smaller than 
received session data THEN; 
return message incomplete status to user; 
ELSE 

return command completed status to user; 

END 

ELSE 

return command timed out status to user; 

{session data received} 

END 

END; 
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RECEIVE ANY 


PROCEDURE Receive Any (command block); 

{receive any data sent to the 

specified name number} 

BEGIN 

IF name number is illegal THEN; 

return illegal name number 

status to user; 

ELSE 

IF session is closed and session closed 

status has not been reported THEN; 

return session closed status to user; 

ELSE 

IF session is aborted and session aborted 

status has not been reported THEN; 

return session aborted status to user; 

ELSE 

BEGIN 

REPEAT 

BEGIN 

wait for a session message (data packet(s)); 
IF RECEIVE specific is specified THEN; 
BEGIN 

check recipient name in session message; 
IF recipient name in session message is 
same as local name THEN; 

set receive completed indicator; 

{receive to specific name satisfied} 
ELSE 

reset receive completed indicator; 

{receive to specific not satisfied, 
continue to wait} 

END 

ELSE 

set receive completed indicator; 

{receive to any name satisfied} 


C-30 Protocols 



END 

UNTIL receive completed indicator is set; 

IF “conflict detected’’ error THEN; 

return name conflict detected status to user; 

ELSE 

send ack packet(s) to sending node; 
transfer session data to user buffer 
of appropriate length; 
return actual length of transfer to user; 
return recipient name number to user; 

return local session number to user; 

IF size of user buffer is smaller than 
received session data THEN; 
return message incomplete status to user; 
ELSE 

return command completed status to user; 

{session data received} 

END 

END; 
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SESSION STATUS 


PROCEDURE Session Status (command block); 

{obtain status of session indicated by name} 

BEGIN 

IF buffer length is illegal THEN; 

return illegal buffer length status to user; 

ELSE 

BEGIN 

IF name in conflict THEN 

return “name conflict detected” status to user; 

IF name does not start with * THEN; 
search for name in local name table; 
return number of pending sessions; 
return number of pending datagram receives; 

IF name or * is found THEN; 

BEGIN 

get session status in session table 
for each session on the name or; 
for all session if * ; 
return session status to user; 
return actual length of session status; 

IF size of user buffer is smaller than 
size of session status data THEN; 
return message incomplete status to user; 
ELSE 

return command completed status to user; 

END 

ELSE 

return illegal name status to user; 

END 

END; 
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SEND DATAGRAM 


PROCEDURE Send Datagram (command block) ; 

{send datagram to remote node with the specified 
name registration} 

BEGIN 

IF buffer length is illegal THEN; 

return illegal buffer length status to user; 

ELSE 

BEGIN 

search for name corresponding to name number 
in local name table; 

IF name in conflict THEN; 

return name conflict status to user; 

ELSE 

IF name is not found THEN; 

return illegal name number status to user; 

ELSE 

BEGIN 

send datagram to destination node; 

return command completed status to user; 

END 

END 

END; 
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SEND BROADCAST DATAGRAM 


PROCEDURE Send ^Broadcast ^Datagram (command_ 

block); 

{send broadcast datagram to all nodes on the network} 
BEGIN 

IF buffer length is illegal THEN; 

return illegal buffer length status to user; 

ELSE 

BEGIN 

search for name in local name table; 

IF name in conflict THEN; 

return name conflict status to user; 

ELSE 

IF name is not found THEN; 

return illegal name number status to user; 

ELSE 

BEGIN 

broadcast datagram to all nodes on the network; 

return command completed status to user; 

END 

END 

END; 
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RECEIVE DATAGRAM 


PROCEDURE Receive Datagram (command block); 

{receive datagram from any node on the network} 
BEGIN 

search for name corresponding to name number 
in local name table; 

IF name is not found THEN; 

return illegal name number status to user; 

ELSE 

BEGIN 

REPEAT 

BEGIN 

wait for arrival of datagram; 

IF datagram receive specific is specified THEN; 
BEGIN 

check recipient name in datagram message; 

IF recipient name in datagram message is same 
as name specified by local name 
number THEN ; 

set receive completed indicator; 

{datagram receive to 
specific name satisfied} 

ELSE 

reset receive completed indicator; 

{datagram receive not satisfied, 
continue to wait} 

END 

ELSE 

set receive completed indicator; 

{datagram receive to any name satisfied} 

END 

UNTIL receive completed indicator is set; 

IF “conflict detected” error THEN; 

return name conflict detected status to user; 

ELSE 

transfer datagram data to user buffer 
of appropriate length; 
return actual length of transfer to user; 
return local name number to user; 
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return sender’s name to user; 

IF size of user buffer is smaller than 
received datagram THEN; 
return message incomplete status to user; 
{data received, unable to 
transfer entire message} 

ELSE 

return command completed status to user; 

{datagram received} 

END 

END; 
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RECEIVE BROADCAST DATAGRAM 


PROCEDURE Receive Broadcast Datagram (command 
block) ; 

{receive broadcast datagram from 
any node in the network} 

BEGIN 

search for name corresponding to name number in 
local name table; 

IF name is not found THEN; 

return illegal name number status to user; 

ELSE 

wait for arrival of broadcast datagram; 

IF “conflict detected’’ error THEN; 

return name conflict detected status to user; 

ELSE 

transfer datagram to user buffer 
of appropriate length; 
return actual length of transfer to user; 
return sender’s name to user; 

IF size of user buffer is smaller than received 
datagram THEN; 

return message incomplete status to user; 
{broadcast datagram received, unable to return 
entire message} 

ELSE 

return command completed status to user; 

{broadcast datagram received} 

END; 
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Timer Expiration Processing 


This section describes the pseudo code processing that 
is performed when a timer expires. 


PROCEDURE packet associated timer expiration 

BEGIN 

CASE outstanding packet type OF 
name query: 

IF retransmit counter is less than 
maxRe transmit THEN; 
increment retransmit counter; 
reset and restart timer; 

send another name query packet; 

ELSE 

IF non-accept query response 
received THEN 
return non-accept query 
status to user; 

ELSE 

return unknown remote name 

status to user; 

send name query cancel packet; 

name claim: 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 
reset and restart timer; 

send another name claim packet; 

ELSE 

return name number and command 

completed status to user; 

nonexclusive name claim; 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 
reset and restart timer; 
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send another nonexclusive name 
claim packet; 

ELSE 

return name number and command 

completed status to user; 

session request: 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 
reset and restart timer; 

send another session request packet; 

ELSE 

return command timed out status to user; 

session accept: 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 
reset and restart timer; 

send another session accept packet; 

ELSE 

send abort packet; 

return session aborted to user; 

positive name query response: 
release connection resources; 

IF name not registered more than once THEN 
return name conflict status to user; 


data: 

IF retransmit counter is less than 
maxRetransmit THEN; 
increment retransmit counter; 
reset and restart timer; 

IF retransmit queue is empty THEN 
format and send ack packet with 
POLL set; 

ELSE 

send last packet in the retransmit 
queue with POLL set; 

ELSE 
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abort the session; 
return session aborted, no 
response status to user; 


close: 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 
reset and restart timer; 
send another close packet; 

ELSE 

abort the session; 
return session aborted, no 
response status to user; 

status request: 

IF retransmit counter is less than 
maxRetransmit THEN 
increment retransmit counter; 

send another status request packet; 

ELSE 

return no response status to user; 

END CASE 
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PROCEDURE packet associated timer expiration 

BEGIN 

CASE outstanding packet type OF 

session send: 

send abort packet; 

return session send with command 

timed out status; 

session send multiple : 

send abort packet; 

return session send multiple 

with command timed out status; 

session receive : 

return session receive with 

command timed out status; 


END 
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Packet Reception Processing 


This section describes the receipt of packets by the 
protocol software. The conditions for this type of 
processing are as follows: 

• The packet has been received. 

• The packet has gone through CRC checking. 

• The address of this node has matched the address 
in the packet. 


PROCEDURE packet received 

BEGIN 

CASE packet type OF 
name query: 

IF DNODEID does not match local node name or any 
currently enabled group address THEN; 

ignore packet; 

ELSE 

IF packet arrived with same SNODEID 
and DID THEN; 
ignore this packet; 

ELSE 

IF DNAME is stored in local name table THEN 
IF resources exist for a new session THEN 

send positive name query ^response 

packet to sender and start timer; 

ELSE 

send negative name query response 

packet to sender; 

ELSE 

ignore packet and send no response; 
name claim: 

IF DNODEID does not match local node name or any 
currently enabled group address THEN 
ignore packet; 
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ELSE 

IF packet arrived with same SNODEID 
and DID THEN 
ignore this packet; 

ELSE 

IF DNAME conflicts with a name 
in local name table THEN 

send name claim response packet to sender; 

ELSE 

ignore packet and send no response; 
nonexclusive name claim; 

IF DNODEID does not match local node name or any 
currently enabled group address THEN 
ignore packet; 

ELSE 

IF packet arrived with same SNODEID 
and DID THEN 
ignore this packet; 

ELSE 

IF DNAME conflicts with a name exclusively 
registered in local name table THEN 

send name claim response packet to sender; 

ELSE 

ignore packet and send no response; 

positive name query response: 

match this packet with the originating active open; 

cancel timer associated with previous name query; 

identify the session established by the SNCID and the 

CONNID values; 

send session request packet; 

start timer for session request packet; 

negative name query response; 

match this packet with the originating active open; 
cancel timer associated with previous name query; 

return command completed, session 

open rejected to user 

name query cancel: 

match this packet with any half-estabUshed connection 
(SNODEID and SCONNID); 
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IF match is found THEN 

release associated connection resources; 
issue tear down to lower layer; 

ELSE 

ignore this packet; 

name claim response; 

remove name from local name table; 

cancel timer associated with previous name claim; 

return name in use status to user; 

session request: 

cancel positive name query response timer; 

IF passive open specific is outstanding with remote name 
equal to SNAME and local name equal to DNAME THEN 

send session accept packet over session; 

start timer for session accept; 

choose local session no for this session; 

return command completed status to user; 

ELSE 

IF passive open non-specific is outstanding with local name 
equal to DNAME THEN 

send session accept packet over session; 

start timer for session accept; 

choose local session number 

for this session; 
set remote name = SNAME; 

return command completed status to user; 

ELSE 

send session rejected packet over session; 
session accept: 

cancel timer associated with previous session request; 

choose local session number for this session; 

return local session number to user; 

return command completed status to user; 

{session established} 

session reject: 

cancel timer associated with previous session request; 
return session open rejected status to user; 
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session data: 

remove all acknowledged packets from retransmit queue; 
note remote entity’s current window value (WIN); 
cancel all associated timers; 

IF SEQ is not the next expected value THEN 
IF nack packet has not been sent THEN 
send nack packet; 

ELSE 

ignore packet; 

ELSE 

{SEQ is next expected} 

IF POLL is indicated THEN 
send ack; 

transfer session data to user buffer 

specified in session receive 

command; 

IF size of user buffer is smaller than 
received session data THEN 

return message incomplete status to user; 

ELSE 

{EOM is indicated} 

return actual amount received to user; 

return command completed status to user 

REPEAT for each outstanding session send and 

session send multiple command; 

IF all data has been acked THEN 
return command with success status; 

UNTIL all session send and session send multiple 

commands have been examined; 

IF no session send or session_ send multiple 

commands are pending AND a session close is 

pending THEN 
send a close packet; 


ack: 

remove all acknowledged packets from the retransmit 
queue; 

note remote entity’s current window value (WIN); 
restart timers on unacknowledged packets; 
cancel timers on acknowledged packets 

REPEAT for each outstanding session send and 

session send multiple command; 

IF all data has been acked THEN 
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return command with success status; 

UNTIL all session send and session send multiple 

commands have been examined; 

IF no session send or session send multiple 

commands are pending AND a session close is 

pending THEN 
send a close packet; 


nack; 

remove all acknowledged packets from the retransmit 
queue; 

note remote entity’s current window value (WIN); 
restart timers on unacknowledged packets; 
cancel timers on acknowledged packets; 
retransmit last unacknowledged (last) packet(s); 

REPEAT for each outstanding session send and 

session send multiple command; 

IF all data has been acked THEN 
return command with success status; 

UNTIL all session send and session send multiple 

commands have been examined; 

IF no session send or session send multiple 

commands are pending AND a session close is 

pending THEN 
send a close packet; 


close: 

IF local user initiated the close THEN 
send closed packet; 
close the session; 

return command completed status to user 

ELSE 

{close packet received from close initiator} 
initialize'' retry counter; 
initiahze retransmission timer; 
send close packet to close initiator 

closed: 

notify user that connection is closed; 
user datagram: 

IF DNAME is not *broadcast THEN 
BEGIN {non-broadcast datagram received} 
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IF previous packet arrived with 
same SNODEID and DID THEN 
ignore this packet 

IF no pending datagram receive command exists THEN 
ignore packet 
REPEAT 

{check if received datagram matches a 
receive specific} 

choose next pending datagram receive specific 
IF DNAME = local name THEN 
BEGIN 

{datagram receive to specific name 
satisfied] 

transfer datagram data to user buffer 
of appropriate length; 
return actual length of transfer to user; 

return local name number to user; 

return SNAME to user; 

IF size of user buffer is smaller than 
received datagram THEN 
BEGIN 

return message incomplete status to user; 
{datagram received, unable to transfer 
entire message] 

END 

ELSE 

return command completed status to user 

{datagram received] 

END 

UNTIL all datagram receive specific commands checked 
{datagram receive to any name satisfied] 
transfer datagram data to user buffer; 
return actual length of transfer to user; 

return local name number to user; 

return SNAME to user; 

IF size of user buffer is smaller than 
received datagram THEN 
BEGIN 

return message incomplete status to user; 
{datagram received, unable to 
transfer entire message] 

END 

ELSE 
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return command ^completed status to user 

{datagram received] 

END {non-datagram received] 

ELSE {broadcast datagram received] 

BEGIN 

IF broadcast datagram is sent by the 
same local name THEN 
ignore datagram 

{broadcast datagram receive no satisfied, 
continue to wait] 

ELSE 

IF previous packet arrived with 
same SNODEID and DID THEN 
ignore this packet 
IF no broadcast datagram receive 
command outstanding THEN 
ignore packet 
ELSE 

choose next pending broadcast datagram receive 
transfer broadcast datagram to user buffer; 
return actual length of transfer to user; 
return sender’s name to user; 

IF size of user buffer is smaller than received 
datagram THEN 

return message incomplete status to user; 
{broadcast datagram received, unable to 
return entire message] 

ELSE 

return SNAME to user; 

return command completed status to user 

{broadcast datagram received] 

END {broadcast datagram received] 

status request: 

IF DNODEID does not match local node name or any 
currently enabled group address THEN 
ignore packet 
ELSE 

IF previous packet recently arrived with same 
SNODEID and DID THEN 
ignore this packet 
ELSE 

search for name in local name table; 
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IF name is found THEN 
send status response' packet; 

ELSE 

ignore this packet; 
status response: 

IF DNODEID does not match local node name or any 
currently enabled group address THEN 
ignore packet 
ELSE 

IF previous packet arrived with same SNODEID 
and DID THEN 
ignore this packet 
ELSE 

cancel timer associated with previous status 
request; 

return configuration parameters and status; 
return actual length of configuration parameter 
and status; 

IF size of user buffer is smaller than the 
configuration parameter and status THEN 
return message incomplete status to user; 
ELSE 

return command completed status to user 

END CASE; 
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Field Definitions 

This section describes the fields found within the 
protocol packet types. 


Field 

ACK 


ALGNERRS 


ALIASNAME 


Meaning 

This field is an 8-bit field that 
includes the sequence number + 1 
modulo 256 of the last correctly 
received packet. 

This is a 16-bit field specifying the 
number of packets received with 
alignment errors. 

This is the 16-byte field containing 
the name. 


ALIASNR This is an 8-bit specifying the 

number that is assigned to a given 
name. 

ALIASTAT The low order 4-bits specify the 

status of a name. See “* Local 
name table — 16 entries of 18 
bytes each” on page 2-35 for the 
numbers that are returned in this 
field. 


CLREAS This is an 8 -bit reason code 

indicating the reason for a 
connection being closed. 
CLREAS = OOH indicates a 
normal close. 


CMDRESP This is a 1-bit flag indicating 

whether the packet contains a 
command or a response to a 
command. 


C-50 Protocols 



COLLISIONS 

CONNID 

CRC 

CRCERRS 

DADDR 

DATA 

DID 

DLEN 


This is 16-bit field specifying the 
number of transmitted packets 
that experienced collisions. 

This is a 16-bit identifier used to 
determine which session a packet 
is assigned to. 

This is a 32-bit field containing the 
cyclic redundancy check for the 
packet according to the Autodin-II 
32-bit polynomial generator. 

This is a 16-bit field specifying the 
number of CRC errors being 
reported. 

This 48-bit field is used to identify 
the destination Link level address 
of the packet. A value of all 
binary ones indicates a broadcast. 
All other adapter addresses will 
have the 16 highest bits set to 
zero. A value whose least 
significant bits are hex FF 
indicates a group address of the 
form f(name). 

DATA is a variable length field 
containing user data. 

DID is a 16-bit field that is 
incremented with each 
retransmission of a name query, 
name claim, and a get status 
packet. 

This 16-bit field contains the 
length of the data field specified in 
b3rtes of the Link level packet. 
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Ul'NAlVUL 

DNCID 

DNODEID 

EFD 

EOM 

JUMPSTATl 

JUMPSTAT2 

NACKREAS 


mis IS a 16-bit field that identifies 
the name of a destination (ASCII 
characters). 

This is a 16-bit field used with the 
CONNID to determine the session 
for each packet or to identify a 
datagram. 

This is a 48-bit field indicating the 
Link level address of an intended 
destination. 

This is an 8-bit end frame 
delimiter flag ( 7EH ). 

This is a 1-bit end of message 
indicator. The bit marks the end 
of a user’s logical message. 

This is the 1-bit field indicating 
the status of jumper W 1 . When 
set to 1, jumper W1 is in place. 

This is the 1-bit field indicating 
the status of jumper W2. When 
set to 1, jumper W2 is in place. 

This is the 8-bit reason code 
indicating the reason why a packet 
was not successfully delivered. 

The following is a list of the codes 
that can be contained in this field. 


• OOH-No specific reason 

• 18H-Nack response to an unexpected open 
request 

• 20H-Incompatible RSP version 

• 22H-Bad service ID 

• 24H-Invahd RSP control information 

• 26H-No remote resources 
. 32H-OK 

• 34H-Name claim rejected 
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• 35H-Name query rejected 

NODEIDMASK This is a 6-byte mask used in a 
logical AND operation to get the 
destination node name. 


NODEIDMATCH This is the 6-byte match value to 
use in the operation; permanent 
node name AND NODEIDMASK 
equals NODEIDMATCH. 

NRALIAS This is the 16-bit field specifying 

the number of names to follow. 


PKTSIZE 


PNCID 


PNODEID 


This is a 1 6-bit field indicating the 
maximum packet size that an 
initiating session node is willing to 
accept. 

This is a 16-bit field used with the 
CONNID to determine the 
network connection with which a 
packet is associated at a previous 
node or to identify a datagram. 

This is a 48-bit field indicating the 
Link level address of the previous 
node. 


POLL 


RECVMSGS 


REPORTPD 


This is a 1-bit field when set to 
OSH, indicates that a return packet 
should be generated back to the 
sender. OOH indicates no poll. 

This is a 32-bit field specifying the 
number of packets that have been 
successfully received for a given 
period of time. 

This is a 16-bit field specifying the 
period of time, in minutes, for the 
statistical data that was gathered. 
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RVAL 

SADDR 

SCONNID 

SEQ 

SHORTFRAMES 

SNAME 

SNCID 

SNODEID 

STD 


This is an 8-bit value indicating 
the reason why a requested session 
was rejected. RVAL = 3 
indicates no matching LISTEN 
co m mand. RVAL = 4 indicates 
incompatible version. 

This is a 48-bit field identifying 
the somce Link level address of 
the packet. 

This is a 16-bit identifier used to 
determine the session number for 
a packet. 

SEQ is an 8-bit session packet 
sequence number. It is 
incremented with each new data 
transmission. 

This is a 16-bit field specifying the 
number of short frames being 
reported. 

This is a 16-bit field containing the 
name of a source node. (Specified 
in ASCII characters) 

This is a 16-bit field used with the 
CONNID to determine the 
network connection with which a 
packet is associated at a source 
node or to identify a datagram. 

This is 4 8 -bit field indicating the 
Link level address of a source 
node. 

STD is an 8-bit start delimiter flag 
( TEH ). 
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TRANSID 

WIN 

XMITABRTS 

XMITMSGS 


This is a 16-bit field indicating the 
transaction ID for status and 
status response packets. 

WIN is a 4-bit field that indicates 
the number of packets beyond the 
ones already acknowledged that 
the sender is willing to accept. 

This is a 16-bit field specifying the 
number of transmitted packets 
that were aborted. 

This is a 32-bit field specifying the 
number of packets that were 
successfully transmitted for a 
given period of time. 
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Packet Types, Formats and Functions 


With the previously defined field semantics, the 
following describes the protocol packet types and their 
functions. 


Name Query Packet 


Name Query Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 5000H 

; Fixed value for 
; this position of 




; packet 

N/A 

IIH 

DB lOH 

; Fixed value for 




; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 




; packets 
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Name Query Packet 


Field Name 

Offset 

Lei^h 

Comments 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

N/A 

15H 

DW 0202H 

; Fixed value for 
; this position of 
; packet 

N/A 

17H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DW OlOOH 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW XXI OH 

; Fixed value for 
; this position of 
; packet 

DNAME 

23H 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

SNAME 

33H 

DB 16 DUP(?) 

; ASCII Name for 
; source 
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Name Query Packet 


Field Name 

Offset 

Lei^h 

Comments 

PNCID 

43H 

DW? 

; (See definition) 

DID 

45H 

DW? 

; Number that is 
; incremented by 
; 1 for each 
; packet 

SNCID 

47H 

DW? 

; Field ID for 
; packet 

DNODEID 

49H 

DW? 

; Low address 


4BH 

DW? 

; Mid address 


4DH 

DW? 

; Hi address 

SNODEID 

4FH 

DW? 

; Low address 


51H 

DW? 

; Mid address 


53H 

DW? 

; Hi address 

PNODEID 

55H 

DW? 

; Low address 


57H 

DW? 

; Mid address 


59H 

DW? 

; Hi address 

CRC 

5BH 

DD? 

; Check byte 

EFD 

5FH 

DB 7EH 

; End-of-packet 
; byte 


DADDR 

This equals f (remote name). 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the Link level 
packet data field. 

WIN 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 
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CONNID 

XXXX 

DNAME 

SNAME 

DID 

SNCID 

PNCID 

DNODEID 

SNODEID 

PNODEID 

CRC 


Choose a new CONNID value on the 
first transmission or repeat the previous 
CONNID on retransmissions. 

The X’s represent a don’t-care value. 

This is equal to the remote name. 

This is equal to the source name. 

Use the next DID value. 

Use the next SNCID value on the first 
transmission or repeat the previous 
SNCID value on retransmission. 

Low-byte of PNCID equals the 
low-byte of SNCID. 

This is equal to f (remote name). 

This is equal to the local node name 

This is equal to SNODEID 

This is the cyclic redundancy check for 
the packet. 
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Name Claim and Name Claim Cancel Packet 


Name Claim and Name Claim Cancel Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 5000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB? 

; lOH = Name Claim 
; packet. AOH = 

; Name Claim 
; Cancel Packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets 

CONNID 

13H 

DW? 

; Field ID for 
; packet 
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Name Claim and Name Claim Cancel Packet 


Field Name Offset Length Comments 


N/A 

15H 

DW 0202H 

; Fixed value for 
; this position of 
; packet 

N/A 

17H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DW 0400H 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 

DNAME 

23H 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

PNCID 

33H 

DW? 

; Equal to SNCID 
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Name Claim and Name Claim Cancel Packet 


Field Name 

Offset 

Length 

Comments 

DID 

35H 

DW? 

; Number that is 
; incremented by 
; 1 for each 
; packet 

SNCID 

37H 

DW? 

; Field ID for 
; packet 

DNODEID 

39H 

DW? 

; Low address 


3BH 

DW? 

; Mid address 


3DH 

DW? 

; Hi address 

SNODEID 

3FH 

DW? 

; Low address 


41H 

DW? 

; Mid address 


43H 

DW? 

; Hi address 

PNODEID 

45H 

DW? 

; Low address 


47H 

DW? 

; Mid address 


49H 

DW? 

; Hi address 

CRC 

4BH 

DD? 

; Check byte 

EFD 

4FH 

DB 7EH 

; End-of -packet 
; byte 


DADDR 

This equals the group address of 
f (remote name). 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the Link level 
packet data field. 

WIN 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 
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CONNID 

XXXX 

DNAME 

PNCID 

DID 

SNCID 

DNODEID 

SNODEID 

PNODEID 

CRC 


Choose a new CONNID value on the 
first transmission or repeat the previous 
CONNID on retransmissions. 

The X’s represent a don’t-care value. 

This is equal to the remote name. 

This is equal to SNCID. 

Use the next DID value. 

Use the next SNCID value on the first 
transmission or repeat the previous 
SNCID value on retransmission. 

This is equal to f (remote name). 

This is equal to the local node name 

This is equal to SNODEID 

This is the cyclic redundancy check for 
the packet. 
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Nonexclusive Name Claim and Nonexclusive Name 
Claim Cancel Packet 


Nonexclusive Name Claim and 
Nonexclusive Name Claim Cancel Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 5000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB? 

; 10H=Nonexclusive 
; Name Claim 
; Packet. A0H=Non- 
; exclusive Name 
; Claim Cancel 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets 


C-64 Protocols 




Nonexclusive Name Claim and 


Nonexclusive Name Claim Cancel Packet 


Field Name 

Offset 

Length 

Comments 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

N/A 

15H 

DW 0202H 

; Fixed value for 
; this position of 
; packet 

N/A 

17H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DW 0600H 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 

DNAME 

23H 

DB 16 DUP(?) 

; ASCII Name for 
; destination 
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Nonexclusive Name Claim and 


Nonexclusive Name Claim Cancel Packet 


Field Name Offset Length Comments 


PNCID 

33H 

DW? 

; Equal to SNCIE 

DID 

35H 

DW? 

; Number that is 
; incremented by 
; 1 for each 
; packet 

SNCID 

37H 

DW? 

; Field ID for 
; packet 

DNODEID 

39H 

DW? 

; Low address 


3BH 

DW? 

; Mid address 


3DH 

DW? 

; Hi address 

SNODEID 

3FH 

DW? 

; Low address 


41H 

DW? 

; Mid address 


43H 

DW? 

; Hi address 

PNODEID 

45H 

DW? 

; Low address 


47H 

DW? 

; Mid address 


49H 

DW? 

; Hi address 

CRC 

4BH 

DD? 

; Check byte 

EFD 

4FH 

DB 7EH 

; End-of -packet 
; byte 


DADDR 

This equals the group address of 
f (remote name). 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the Link level 
packet data field. 
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WIN 

CONNID 

XXXX 

DNAME 

PNCID 

DID 

SNCID 

DNODEID 

SNODEID 

PNODEID 

CRC 


This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

Choose a new CONNID value on the 
first transmission or repeat the previous 
CONNID on retransmissions. 

The X’s represent a don’t-care value. 

This is equal to the remote name. 

This is equal to SNCID. 

Use the next DID value. 

Use the next SNCID value on the first 
transmission or repeat the previous 
SNCID value on retransmission. 

This is equal to f (remote name). 

This is equal to the local node name 

This is equal to SNODEID 

This is the cyclic redundancy check for 
the packet. 
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Positive Name Query Response 


Positive Name Query Response 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 3000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB 20H 

; Fixed value for 
; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 
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Positive Name Query Response 


Field Name 

Offset 

Length 

Comments 

SCONNID 

15H 

DW? 

; Connection 
; ID of ses- 
; sion 

N/A 

17H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DWOlOlH 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW 001 OH 

; Fixed value for 
; this position of 
; packet 

DNAME 

23H 

DB 16DUP(?) 

; ASCII Name for 
; destination 

SNAME 

33H 

DB 16 DUP(?) 

; ASCII Name for 
; source 
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Positive Name Query Response 


Field Name Offset Lei^h Comments 


DNCID 

43H 

DW? 

Number used to 
determine 
the session for 
packet or to 
identify data- 
gram 

SNCID 

45H 

DW? 

Field ID for 
packet 

SNODEID 47H 

DW? 

Low address 


49H 

DW? 

Mid address 


4BH 

DW? 

Hi address 

CRC 

4DH 

DD? 

Check byte 

EFD 

51H 

DB 7EH 

End-of -packet 
byte 


DADDR 

This equals the address of the queried 
node. 


SADDR 

This equals the address of the 
transmitting node. 


DLEN 

This equals the length of the Link level 
packet data field. 


WIN 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 


CONNID 

This field is equal to the appropriate 


connection ID indicating the session 
and associated packet. 


C-70 Protocols 



SCONNID 

XXXX 

DNAME 

SNAME 

DNCID 

SNCID 

SNODEID 

CRC 


This field is equal to the connection ID 
indicating the session of the requesting 
node. 

The X’s represent a don’t-care value. 

This is equal to the remote name. 

This is equal to the source name. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This field is equal to the session 
identifier for the source node. 

This is equal to the local node name 

This is the cyclic redundancy check for 
the packet. 
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Negative Name Query Response 


Negative Name Query Response 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB 30H 

; Fixed value for 
; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 
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Negative Name Query Response 


Field Name 

Offset 

Length 

Comments 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

N/A 

15H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

NACK- 

REAS 

17H 

DB OOH 

; Reason why 
; packet nacked. 

N/A 

18H 

DBXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DWOlOlH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

23H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

25H 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

27H 

DW XXI OH 

; Fixed value for 
; this position of 
; packet 
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Negative Name Query Response 


Field Name Offset Length Comments 


DNAME 29H 

SNAME 39H 

DNCID 49H 

CRC 4BH 

EFD 4FH 


DB 16 DUP(?) 
DB 16 DUP(?) 

DW? 

DD? 

DB 7EH 


; ASCII Name for 
; destination 

; ASCII Name for 
; source 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

; Check byte 

; End-of-packet 
; byte 


DADDR This equals the address of the queried 

node. 


SADDR 

DLEN 

WIN 

CONNID 

XXXX 


This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

The X’s represent a don’t-care value. 
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NACKREAS 

DNAME 

SNAME 

DNCID 

CRC 


This is set to indicate the reason why a 
packet was nacked. 

This is equal to the remote name. 

This is equal to the source name. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Name Claim Response 


Name Claim Response 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB 30H 

; Fixed value for 
; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 
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Name Claim Response 


Field Name 

Offset 

Length 

Comments 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

N/A 

15H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

NACK- 

REAS 

17H 

DB? 

; Reason why 
; packet nacked. 

N/A 

18H 

DBXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DW 040 IH 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 
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Name Claim Response 


Field Name Offset Lei^h Comments 


DNAME 

23H 

DB 16 DUP(?) 

ASCII Name for 
destination 

DNCID 

33H 

DW? 

Number used to 
determine 
the session for 
packet or to 
identify data- 
gram 

CRC 

35H 

DD? 

; Check byte 

EFD 

39H 

DB 7EH 

; End-of -packet 
; byte 


DADDR This equals the group address of 

remote name. 

SADDR This equals the address of the 

transmitting node. 

DLEN This equals the length of the Link level 

packet data field. 

WIN This equals the current value indicating 

the number of packets the sender is 
willing to accept. 

CONNID This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

NACKREAS This is set to indicate the reason why a 
packet was nacked. 

XXXX The X’s represent a don’t-care value. 
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DNAME 

SNAME 

DNCID 

CRC 


This is equal to the remote name. 

This is equal to the source name. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session. 

This is the cycUc redundancy check for 
the packet. 
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Name Query Cancel Packet 


Name Query Cancel Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 5000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB AOH 

; Fixed value for 
; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets 

CONNID 

13H 

DW? 

; Field ID for 
; packet 
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Name Query Cancel Packet 


Field Name 

Offset 

Length 

Comments 

N/A 

15H 

DW 0202H 

; Fixed value for 
; this position of 
; packet 

N/A 

17H 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

19H 

DW OlOOH 

; Fixed value for 
; this position of 
; packet 

N/A 

IBH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IDH 

DW XXXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

N/A 

IFH 

DW lOXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

21H 

DW XXI OH 

; Fixed value for 
; this position of 
; packet 

DNAME 

23H 

DW 16DUP(?) 

; ASCII Name for 
; destination 

SNAME 

33H 

DW 16DUP(?) 

; ASCII Name for 
; source 

PNCID 

43H 

DW? 

; (See definition) 
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Name Query Cancel Packet 


Field Name 

Offset 

Length 

Comments 

DID 

45H 

DW? 

; Number that is 
; incremented by 
; 1 for each 
; packet 

SNCID 

47H 

DW? 

; Field ID for 
; packet 

DNODEID 

49H 

DW? 

; Low address 


4BH 

DW? 

; Mid address 


4DH 

DW? 

; Hi address 

SNODEID 

4FH 

DW? 

; Low address 


51H 

DW? 

; Mid address 


53H 

DW? 

; Hi address 

PNODEID 

55H 

DW? 

; Low address 


57H 

DW? 

; Mid address 


59H 

DW ? 

; Hi address 

CRC 

5BH 

DD? 

; Check byte 

EFD 

5FH 

DB 7EH 

; End-of-packet 
; byte 


DADDR 

This equals the group address of 
remote name. 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the Link level 
packet data field. 

WIN 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 
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CONNID 

Choose a new CONNID value on the 
first transmission or repeat the previous 
CONNID on retransmissions. 

XXXX 

The X’s represent a don’t-care value. 

DNAME 

This is equal to the remote name. 

SNAME 

This is equal to the source name. 

PNCID 

Low-order byte of PNCID equals 
low-order byte of SNCID. 

DID 

Use the next DID value. 

SNCID 

Use the next SNCID value on the first 
transmission or repeat the previous 
SNCID value on retransmission. 

DNODEID 

This is equal to f (remote name). 

SNODEID 

This is equal to the local node name 

PNODEID 

This is equal to SNODEID 

CRC 

This is the cyclic redundancy check for 
the packet. 
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Session Request 


Session Request 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


OSH 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 0040H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 0?H 

; (00-07)H 
; means no poll 
; (08-0F)H 
; means to send 
; a return packet. 
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Session Request 


Field Name 

Offset 

Length 

Comments 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; -1-1 modulo 256 
; of last 
; correctly 
; received packet 

N/A 

17H 

DW 000 IH 

; Fixed value for 
; this position of 
; packet 

PKTSIZE 

19H 

DW? 

; Packet size that 
; can be accepted 
; from the remote 
; node. 

N/A 

IBH 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 

N/A 

IDH 

DW lOlOH 

; Fixed value for 
; this position of 
; packet 
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Session Request 


Field Name Offset 

Length 

Comments 

SNAME 

IFH 

DB 16DUP(?) 

; ASCII Name for 
; source 

DNAME 

2FH 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

DNCID 

3FH 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

41H 

DD? 

; Check byte 

EFD 

45H 

DB 7EH 

; End-of-packet 
; byte 


DADDR 

This equals the address of the next 
node of a network connection. 
(Possibly the destination node.) 


SADDR 

This equals the address of the 
transmitting node. 


DLEN 

This equals the length of the Link level 


packet data field. 

POLL When this byte is set to (08-0F)H, the 

receiver is requested to send a return 
packet. When this byte is set to 
(00-07)H, indicates no poll. 

WIN This equals the current value indicating 

the number of packets the sender is 
willing to accept. 
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CONNID 

SEQ 

ACK 

PKTSIZE 

SNAME 

DNAME 

DNCID 

CRC 


This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. T h is 
number indicates the next expected 
sequence number to be received. 

Set this size to the maximum that an 
initiating session entity will accept. 

This is equal to the source name. 

This is equal to the destination name. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Session Accept 


Session Accept 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB TEH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 0040H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 0?H 

; (00-07)H 
; means no poll 
; (08-0F)H 
; means to send 
; a return packet. 
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Session Accept 


Field Name Offset Length Comments 


WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW DUP(O) 

; Field ID for 
; packet 

SEQ 

15H 

DB ? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; +1 modulo 256 
; of last 
; correctly 
; received packet 

N/A 

17H 

DW 0002H 

; Fixed value for 
; this position of 
; packet 

PKTSIZE 

19H 

DW? 

; Packet size that 
; can be accepted 
; from the remote 
; node. 

DNCID 

IBH 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

IDH 

DD DUP(O) 

; Check byte 
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Session Accept 


Field Name Offset Length Comments 


EFD 22H DB7EH ; End-of-packet 

; byte 


DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

PKTSIZE 


This equals the group address of the 
responding node. 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (08-0F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(00-07 )H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

Set this size to the maximum that an 
initiating session entity will accept. 
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DNCID 


CRC 


This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Session Reject 


Session Reject 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


OSH 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 0?H 

; (00-07)H 
; means no poll 
; (08-0F)H 
; means to send 
; a return packet. 
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Session Reject 


Field Name Offset Length Comments 


WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB ? 

; Number that in- 
; eludes number 
; -1-1 modulo 256 
; of last 
; correctly 
; received packet 

N/A 

17H 

DB OSH 

; Fixed value for 
; this position of 
; packet 

RVAL 

18H 

DB? 

; Value to indicate 
; why session was 
; rejected. 

DNCID 

19H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

IBH 

DD? 

; Check byte 
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Session Reject 


Field Name Offset Length Comments 


EFD IFH DB7FH ; Fnd-of-packet 

; byte 


DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

RVAL 


This equals the group address of the 
responding node. 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (08-0F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(00-07)H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

This field indicates the reason code for 
the session reject. 
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DNCID 


CRC 


This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Ack Packet 


Ack Packet 

Field Name Offset Lei^h Comments 


STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW ? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 4?H 

; (40-47)H 
; means no poll. 

; (48-4F)H 
; means to send 
; a return packet. 
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Ack Packet 


Field Name 

Offset 

Length 

Comments 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; +1 modulo 256 
; of last 
; correctly 
; received packet. 

N/A 

17H 

DBXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

DNCID 

18H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

lAH 

DD? 

; Check byte 

EFD 

lEH 

DB 7EH 

; End-of-packet 
; byte 
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DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

DNCID 

CRC 


This equals the group address of the 
responding node. 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (48-4F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(40-47)H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Nack Packet 


Nack Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


OSH 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 5?H 

; (50-57)H 
; means no poll. 

; (58-5F)H 
; means to send 
; a return packet. 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 
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Nack Packet 


Field Name Offset 

Length 

Comments 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; + 1 modulo 256 
; of last 
; correctly 
; received packet. 

NACK- 

REAS 

17H 

DB? 

; Reason why 
; packet not 
; received. 

DNCID 

18H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify 
; datagram 

CRC 

lAH 

DD ? 

; Check byte 

EFD 

lEH 

DB 7EH 

; End-of -packet 
; byte 


DADDR 

This equals the group address of the 
responding node. 


SADDR 

This equals the address of the 
transmitting node. 


DLEN 

This equals the length of the Link level 
packet data field. 
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POLL 


When this byte is set to (58-5F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(50-5 7 )H, indicates no poll. 

WIN This equals the current value indicating 

the number of packets the sender is 
willing to accept. 

CONNID This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

SEQ This field is equal to the session packet 

sequence number for this packet. 

ACK This field is equal to the 

acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

NACKREAS This field is equal to the code 

indicating the reason for the nacked 
packet. 

DNCID This field is equal to the session 

identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

CRC This is the cyclic redundancy check for 

the packet. 
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Close Packet 


Close Packet 

Field Name Offset Length Comments 


STD 

OOH 

DB 7EH ; 

Start delimiter 




flag byte 

DADDR 

OlH 

DW? ; 

Low address 


03H 

DW? ; 

Mid address 


OSH 

DW? ; 

Hi address 

This is the 
next node 
address 
(initiator’s 
address) 

SADDR 

07H 

DW? 

Low address 


09H 

DW? 

Mid address 


OBH 

DW? 

Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

Fixed value for 
this position of 




packet 

POLL 

IIH 

DB 6?H 

(60-67)H 
means no poll. 
(68-6F)H 
means to send 
a return packet. 
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Close Packet 


Field Name 

Offset 

Length 

Comments 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; -1-1 modulo 256 
; of last 
; correctly 
; received packet. 

N/A 

17H 

DBXXH 

; Fixed value for 
; this position of 
; packet 

DNCID 

18H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify 
; datagram 

CRC 

lAH 

DD ? 

; Check byte 

EFD 

lEH 

DB 7EH 

; End-of-packet 
; byte 
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DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

DNCID 

CRC 


This equals the address of the next 
node of a network connection. 

(Possibly the destination node.) 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (68-6F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(60-67)H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Closed Packet 


Closed Packet 


Field Name 

Offset 

Lei^h 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DB 70H 

; Fixed value for 
; this position of 
; packet 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value 
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Closed Packet 


Field Name 

Offset 

Length 

Comments 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; +1 modulo 256 
; of last 
; correctly 
; received packet. 

CLREAS 

17H 

DB? 

; Reason why 
; connection 
; closed. 

DNCID 

18H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

lAH 

DD? 

; Check byte 

EFD 

lEH 

DB 7EH 

; End-of -packet 
; byte 


DADDR This equals the group address of 

remote name. 

SADDR This equals the address of the 

transmitting node. 
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DLEN 

WIN 

CONNID 

SEQ 

ACK 

CLREAS 

DNCID 

CRC 


This equals the length of the Link level 
packet data field. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

This field is equal to the code 
indicating the reason for the 
connection being closed. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Data Packet 


Data Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 0?H 

; (00-07)H 
; means no poll. 

; (08-0F)H 
; means to send 
; a return packet. 
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Data Packet 


Field Name 

Offset 

Length 

Comments 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB? 

; Number that in- 
; eludes number 
; +1 modulo 256 
; of last 
; correctly 
; received packet. 

EOM 

17H 

DB ?0H 

; End-of-mes- 
; sage indicator. 

; (80-F0)H equals 
; end-of-mes- 
; sage. 

DATA 

18H 

DB ?? DUP(?) 

; Variable length 
; field. 

DNCID 

XXH 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

XXH 

DD? 

; Check byte 
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Data Packet 


Field Name Offset Length Comments 


EFD XXH DB7EH ; End-of-packet 

; byte 


DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

EOM 


This equals the next node of a network 
connection. (Possibly the destination 
node.) 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (08-0F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(00-07)H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

When this bit is set to 1, packets 
contains the end of the user’s logical 
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DATA 

DNCID 

CRC 


message. When this bit is set to 0, 
packet does not contain the end of the 
message. 

This is a variable field containing user 
data. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Datagram Packet 


Datagram Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW5100H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DW 01 OOH 

; Fixed value for 
; this position of 
; packet 

N/A 

13H 

DW 000 IH 

; Fixed value for 
; this position of 
; packet 

N/A 

15H 

DW lOlOH 

; Fixed value for 
; this position of 
; packet 
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Datagram Packet 


Field Name 

Offset 

Length 

Comments 

N/A 

17H 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 

SNAME 

19H 

DB 16 DUP(?) 

; Name of source 
; node in ASCII 

DNAME 

29H 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

DATA 

39H 

DB ?? DUP(?) 

; Variable length 
; field. 

PNCID 

XXH 

DW FFFEH 

; Equal to 
; SNCID 

DID 

XXH 

DW? 

; Number that is 
; incremented by 
; 1 for each 
; packet 

SNCID 

XXH 

DW FFFEH 

; Field ID for 
; packet 

DNODEID 

XXH 

DW? 

; Low address 


XXH 

DW? 

; Mid address 


XXH 

DW? 

; Hi address 

SNODEID 

XXH 

DW? 

; Low address 


XXH 

DW? 

; Mid address 


XXH 

DW? 

; Hi address 

PNODEID 

XXH 

DW? 

; Low address 


XXH 

DW? 

; Mid address 


XXH 

DW? 

; Hi address 

CRC 

XXH 

DD? 

; Check byte 
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Datagram Packet 


Field Name Offset Length Comments 


EFD XXH DB7EH ; End-of-packet 

; byte 


DADDR 

This equals the group address of 
remote name. 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the Link level 
packet data field. 

SNAME 

This field is equal to the source name. 

DNAME 

This field is equal to a destination name 
or a " * broadcast" for a broadcast all. 

DATA 

This is a variable field containing user 
data. 

PNCID 

This field is equal to the datagram 
identifier for the previous node. 

DID 

This field is equal to the next DID 
value. 

SNCID 

This field is equal to the datagram 
identifier for the source node. 

DNODEID 

This is equal to the destination node 
name. 

SNODEID 

This is equal to the local node name. 

PNODEID 

This field is equal to the SNODEID 
field. 


C-114 Protocols 




CRC 


This is the cyclic redundancy check for 
the packet. 
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Get Status Packet 


Get Status Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW5100H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DW 0300H 

; Fixed value for 
; this position of 
; packet 

N/A 

13H 

DW 0003H 

; Fixed value for 
; this position of 
; packet 

CMDRESP 

15H 

DB ?2H 

; (02-72)H = 

; command. 

; (82-F2)H = 

; response. 
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Get Status Packet 


Field Name 

Offset 

Length 

Comments 

N/A 

16H 

DBXXH 

; Fixed value for 
; this position of 
; packet 

N/A 

17H 

DW 800 IH 

; Fixed value for 
; this position of 
; packet 

N/A 

19H 

DW 8001H 

; Fixed value for 
; this position of 
; packet 

TRANSID 

IBH 

DW? 

; ID for status 
; and status re- 
; sponse packet 

N/A 

IDH 

DB lOH 

; Fixed value for 
; this position of 
; packet 

DNAME 

lEH 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

N/A 

2EH 

DB OOH 

; Fixed value for 
; this position of 
; packet 

N/A 

2FH 

DW OOOOH 

; Fixed value for 
; this position of 
; packet 

PNCID 

31H 

DW FFFEH 

; Equal to 
; SNCID 

DID 

33H 

DW ? 

; Number that is 
; incremented by 
; 1 for each 
; packet 
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Get Status Packet 


Field Name Offset Lei^h Comments 


SNCID 

35H 

DW FFFEH 

; Field ID for 
; packet 

DNODEID 

37H 

DW? 

; Low address 


39H 

DW? 

; Mid address 


3BH 

DW? 

; Hi address 

SNODEID 

3DH 

DW? 

; Low address 


3FH 

DW? 

; Mid address 


41H 

DW? 

; Hi address 

PNODEID 

43H 

DW? 

; Low address 


45H 

DW? 

; Mid address 


47H 

DW? 

; Hi address 

CRC 

49H 

DD? 

; Check byte 

EFD 

4DH 

DB 7EH 

; End-of-packet 
; byte 


This equals the group address of 
remote permanent node name. 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

CMDRESP When this bit is set to 1 , the packet is a 
response. When set to 0, the packet is 
a command. 

TRANSID This field contains the transaction 
identification number. 


DADDR 

SADDR 

DLEN 
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DNAME 

This field is equal to a destination 
name. 

PNCID 

This field is equal to the datagram 
identifier for the previous node. 

DID 

Use the next DID value. 

SNCID 

This field is equal to the datagram 
identifier for the source node. 

DNODEID 

This is equal to the destination node 
name. 

SNODEID 

This is equal to the local node name. 

PNODEID 

This field is equal to the SNODEID 
field. 

CRC 

This is the cyclic redundancy check for 
the packet. 
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Status Response Packet 


Status Response Packet 


Field Name 

Offset 

Length 

STD 

OOH 

DB 7EH 

DADDR 

OlH 

DW? 


03H 

DW? 


OSH 

DW ? 

SADDR 

07H 

DW ? 


09H 

DW? 


OBH 

DW? 

DLEN 

ODH 

DW? 

N/A 

OEH 

DW5100H 

N/A 

IIH 

DW 03 OOH 

N/A 

13H 

DW 0003H 

N/A 

15H 

DB 82H 

N/A 

16H 

DB OOH 

N/A 

17H 

DW 8001H 

N/A 

19H 

DW 8001H 

TRANSID 

IBH 

DW? 

N/A 

IDH 

DB lOH 

DNAME 

lEH 

DW 16 DUP(?) 

N/A 

2EH 

DB OOH 
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Status Response Packet 


Field Name 

Offset 

Length 

STATLEN 

2FH 

DW? 

DNODEID 

31H 

DW? 


33H 

DW? 


35H 

DW? 

JUMPSTAT 

37H 

DB? 

SELETEST 

38H 

DB OOH 

SWVERSION 

39H 

DW? 

REPORTED 

3BH 

DW? 

CRCERRS 

3DH 

DW ? 

ALGNERRS 

3FH 

DW? 

COLLISIONS 

41H 

DW? 

XMITABRTS 

43H 

DW OOOOH 

XMITMSGS 

45H 

DD ? 

RECVMSGS 

49H 

DD ? 

REXMITCNT 

4DH 

DW? 

NORESOURCES 

4FH 

DW? 

N/A 

51H 

DW XXXXH 

N/A 

53H 

DW XXXXH 

N/A 

55H 

DW XXXXH 

N/A 

57H 

DW XXXXH 
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Status Response Packet 


Field Name 

Offset 

Length 

N/A 

59H 

DW XXXXH 

N/A 

5BH 

DW XXXXH 

N/A 

SDH 

DW XXXXH 

N/A 

5FH 

DW XXXXH 

N/A 

61H 

DW XXXXH 

N/A 

63H 

DW XXXXH 

N/A 

65H 

DW XXXXH 

N/A 

67H 

DW XXXXH 

N/A 

69H 

DW XXXXH 

NRALIAS 

6BH 

DB? 

ALIASNAME 

6CH 

DB 16DUP(?) 

ALIASNR 

7CH 

DB ? 

ALIASTAT 

7DH 

DB? 

o 

XXH 

0 

o 

XXH 

o 

o 

XXH 

o 

ALIASNAME 

XXH 

DB 16DUP(?) 

ALIASNR 

XXH 

DB ? 

ALIASTAT 

XXH 

DB? 
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Status Response Packet 


Field Name Offset Length 


PNCID 

XXH DW FFFEH 

DID 

XXH DW ? 

SNCID 

XXH DW FFFEH 

DNODEID 

XXH DW ? 

XXH DW ? 

XXH DW ? 

SNODEID 

XXH DW ? 

XXH DW ? 

XXH DW ? 

PNODEID 

XXH DW ? 

XXH DW ? 

XXH DW ? 

CRC 

XXH DD ? 

EFD 

XXH DB 7EH 

DADDR 

This equals the group address of 
remote node (g(requesting 
node)). 

SADDR 

This equals the address of the 
transmitting node. 

DLEN 

This equals the length of the 
Link level packet data field. 

TRANSID 

This is the transaction 
identification number 

DNAME 

This is equal to the destination 
name. 
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STATLEN 

DNODEID 

JUMPSTAT 

SELFTEST 

SWVERSION 

REPORTED 

CRCERRS 

ALGNERRS 

COLLISIONS 

XMITABRTS 

XMITMSGS 

RECVMSGS 

REXMITCNT 


This is equal to the offset value 
of NRALIAS minus 12H. 

This is equal to the responding 
node ID. 

Two high order bits, when set to 
1, indicates that jumpers W2 
and W1 are in place. The 
highest order bit corresponds to 
jumper W2. 

This byte is the result code of 
the selftest of the node. 

These bytes are used to indicate 
the software version currently 
used. 

This is indicated in minutes for 
the time since the last hardware 
reset. 

Number of received packets 
with failed CRC checks. 

Number of received packets out 
of alignment. 

Number of collisions 
encountered on transmission 
packets. 

Number of transmitted packets 
that aborted. 

Number of packets successfully 
transmitted by the Link level. 

Number of successfully received 
packets. 

Count of packets retransmitted. 
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NORESOURCES 

NRALIAS 


ALIASNAME 

ALIASNR 

ALIASTAT 

PNCID 

DID 

SNCID 

SNODEID 

PNODEID 


Count of receive failures due to 
lack of resources. 

Number of alias names to follow 
in the packet. The next three 
fields, ALIASNAME, 
ALIASTAT, and ALIASNR, 
are repeated in sequence with 
the number given in the 
NRALIAS field. This fields 
offset can be calculated by using 
the STATLEN field offset and 
adding 12H to it. 

Alias name for 16 bytes. 

Number assigned to the alias 
name. 

This byte indicates the status of 
the name specified in the 
ALIASNAME field. See “* 
Local name table — 16 entries of 
18 bytes each” on page 2-33 for 
the values in this field. 

This field is equal to the 
datagram identifier for the 
previous node. 

Use the next DID value. 

This field is equal to the 
datagram identifier for the 
source node. 

This is equal to the local node 
name. 

This field is equal to the 
SNODEID field. 
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CRC 


This is the cyclic redundancy 
check for the packet. 
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Abort Packet 


Abort Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 
; This is the 
; next node 
; address 
; (initiator’s 
; address) 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW 4000H 

; Fixed value for 
; this position of 
; packet 

POLL 

IIH 

DB 9?H 

; (90-97)H 
; means no poll. 

; (98-9F)H 
; means to send 
; a return packet. 
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Abort Packet 


Field Name 

Offset 

Length 

Comments 

WIN 

12H 

DB 0?H 

; Low-order 4-bits 
; define number of 
; packets. High- 
; order 4-bits are 
; fixed value. 

CONNID 

13H 

DW? 

; Field ID for 
; packet 

SEQ 

15H 

DB ? 

; Session packet 
; sequence 
; number 

ACK 

16H 

DB ? 

; Number that in- 
; eludes number 
; -Hi modulo 256 
; of last 
; correctly 
; received packet. 

N/A 

17H 

DBXXH 

; Don’t-care value 
; for this 
; position of 
; packet 

DNCID 

18H 

DW? 

; Number used to 
; determine 
; the session for 
; packet or to 
; identify data- 
; gram 

CRC 

lAH 

DD ? 

; Check byte 

EFD 

lEH 

DB 7EH 

; End-of-packet 
; byte 
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DADDR 

SADDR 

DLEN 

POLL 

WIN 

CONNID 

SEQ 

ACK 

DNCID 

CRC 


This equals the address of the next 
node of a network connection. 

(Possibly the destination node.) 

This equals the address of the 
transmitting node. 

This equals the length of the Link level 
packet data field. 

When this byte is set to (98-9F)H, the 
receiver is requested to send a return 
packet. When this byte is set to 
(90-97)H, indicates no poll. 

This equals the current value indicating 
the number of packets the sender is 
willing to accept. 

This field is equal to the appropriate 
connection ID indicating the session 
and associated packet. 

This field is equal to the session packet 
sequence number for this packet. 

This field is equal to the 
acknowledgment sequence number. This 
number indicates the next expected 
sequence number to be received. 

This field is equal to the session 
identifier for the destination node. 

This field is used with CONNID to 
specify the destination session.) 

This is the cyclic redundancy check for 
the packet. 
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Self-Test Packet 


Self-Test Packet 


Field Name 

Offset 

Length 

Comments 

STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW FOOOH 

; Fixed value for 
; this position of 
; packet 

CRC 

IIH 

DD? 

; Check byte 

EFD 

15H 

DB 7EH 

; End-of-packet 
; byte 


DADDR This equals the address of the 

transmitting node. 

SADDR This equals the address of the 

transmitting node. 

DLEN This equals the length of the Link level 

packet data field. 
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CRC 


This is the cyclic redundancy check for 
the packet. 
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Ident Packet 


Ident Packet 


Field Name Offset Length Comments 


STD 

OOH 

DB 7EH 

; Start delimiter 
; flag byte 

DADDR 

OlH 

DW? 

; Low address 


03H 

DW? 

; Mid address 


OSH 

DW? 

; Hi address 

SADDR 

07H 

DW? 

; Low address 


09H 

DW? 

; Mid address 


OBH 

DW ? 

; Hi address 

DLEN 

ODH 

DW? 

; Length of Link 
; level packet 

N/A 

OFH 

DW5100H 

; Fixed value for 
; this position of 
; packet 

N/A 

IIH 

DW 03 OOH 

; Fixed value for 
; this position of 
; packet 

N/A 

13H 

DW 0003H 

; Fixed value for 
; this position of 
; packet 

CMDRESP 

15H 

DB ?1H 

; 41H = command 
; CIH = response 

N/A 

16H 

DB OOH 

; Fixed value for 
; this position of 
; packet 
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Ident Packet 


Field Name 

Offset 

Length 

Comments 

N/A 

17H 

DW 8001H 

; Fixed value for 
; this position of 
; packet 

N/A 

19H 

DW 8001H 

; Fixed value for 
; this position of 
; packet 

TRANSID 

IBH 

DW OOOOH 

; ID for status 
; and status re- 
; sponse packet 

N/A 

IDH 

DB lOH 

; Fixed value for 
; this position of 
; packet 

DNAME 

lEH 

DB 16 DUP(?) 

; ASCII Name for 
; destination 

N/A 

2EH 

DB OOH 

; Fixed value for 
; this position of 
; packet 

NODEID- 

2FH 

DW? 

; Mask value 

MASK 

31H 

DW? 

> 


33H 

DW? 


NODEID- 

35H 

DW? 

; Match value 

MATCH 

37H 

DW? 



39H 

DW? 

y 

PNCID 

3BH 

DW FFFEH 

; Equal to 
; SNCID 

DID 

3DH 

DW ? 

; Number that is 
; incremented by 
; 1 for each 
; packet 
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Ident Packet 


Field Name 

Offset 

Length 

Comments 

SNCID 

3FH 

DWFFFEH ; Field ID for 

; packet 

DNODEID 

41H 

DW? 

; Low address 


43H 

DW? 

; Mid address 


45H 

DW? 

; Hi address 

SNODEID 

47H 

DW? 

; Low address 


49H 

DW? 

; Mid address 


4BH 

DW? 

; Hi address 

PNODEID 

4DH 

DW? 

; Low address 


4FH 

DW? 

; Mid address 


51H 

DW? 

; Hi address 

CRC 

53H 

DD? 

; Check byte 

EFD 

57H 

DB 7EH 

; End-of-packet 
; byte 


DADDR This is a broadcast address for 

requests. For a response, this is 
the group address of the initiators 
permanent node name. 

SADDR This equals the address of the 

transmitting node. 

DLEN This equals the length of the Link 

level packet data field, node. 

CMDRESP When this byte is set to CIH, the 

packet is a response. When set to 
41H, the packet is a command. 
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TRANSID 

This field contains the 
transaction identification 
number. 

DNAME 

This field is equal to a destination 
name. 

NODEIDMASK 

Mask value to use against 
destination node name. 

NODEIDMATCH 

Match value to request a 
response. 

PNCID 

This field is equal to FFFEH. 

DID 

Use the next DID value. 

SNCID 

This field is equal to FFFEH. 

DNODEID 

This is equal to the destination 
node name. 

SNODEID 

This is equal to the local node 
name. 

PNODEID 

This field is equal to the 
SNODEID field. 

CRC 

This is the cyclic redundancy 
check for the packet. 
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Protocol Interactions 


This section provides pseudo-code descriptions of the 
interactions of various layers of the communications 
protocols. 


Session to Transport Layer Interactions 

This section is a description of the transfer of data 
between the session and transport layers of the protocol 
architecture. Once a session has been requested by the 
host, the session layer software calls the transport layer 
software to establish a reliable connection between the 
source and destination computers. 


PROCEDURE open RSP connection 

{sourceServicelD, destServicelD, 
networkAddr}; 

BEGIN 

initialize retry count = maxRe transmissions; 
REPEAT 

decrement retry count; 
set open request timer; 
make Send Establish call to PTP; 

{sends open request packet to PTP} 

REPEAT 

wait for response from remote node; 

UNTIL open request timer = 0 or 
response received; 

UNTIL retry count = 0 or response received; 
IF openAck reteived THEN 

{validate that packet was expected} 

IF openAck unexpected THEN ignore it 
ELSE 

store returned destination connection ID; 

return successful open RSP ^connection call 

with proper connection ID to use; 

ELSE IF openNack received THEN 

return failed open RSP connection call 
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with reason code; 

ELSE 

return failed open RSP connection call with 

no response status to user; 

END; 
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Network Layer Interaction 

This section describes the interactions between the 
network layer protocol entities in two adapter cards. 


PROCEDURE send_PTP_packet (NCID, bufAddr, bufLen) 
{requests that the specified buffer be sent to the 
specified NCID} 

BEGIN 

check for parameter error; 
check status of connection 
IF NCID is not valid THEN 

return call as failed with invalid NCID code; 

ELSE IF no connection exists THEN 
return call as failed with connection not; 
established code; 

ELSE IF connection requested 
by remote source THEN 

format and send route completion packet; 

send LAP frame (bufAddr, bufLen, destNodelD) 

ELSE 

format and send connection data packet; 

send LAP frame (bufAddr, bufLen, destNodelD) 

END; 


PROCEDURE send_LAP_frame (bufAddr, 
bufLen, destNodelD) 

{send a buffer of data as the data field of a frame 
to the indicated destination node name} 

BEGIN 

assemble frame 

set destination link level 

address = destNodelD; 

set data field = data buffer; 

generate CRC word for contents of buffer; 

REPEAT 

monitor receiver’s carrier sense signal 
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UNTIL no carrier detected for 

interframe wait time bits; 

transmit frame; 
monitor channel for at least 

collision byte count bytes following preamble; 

IF collision detected or carrier lost THEN 
jam channel; 

increment retransmission counter; 

IF retransmission counter = max THEN 
do not reschedule frame for 
retransmission 
ELSE 

reschedule frame for later 
transmission; 

ELSE 

continue transmission to end of frame; 

END; 


PROCEDURE receive LAP frame 

{LAP takes the bits presented to it from the physical 
layer and transfers a valid frame to PTP} 

BEGIN 

LAP allocates buffer for next incoming frame; 

LAP receives frame from physical layer; 
check DLAddr; 

IF frame is not for this LANA THEN 
ignore frame; 
reallocate buffer 
ELSE 

check CRC; 

IF CRC of frame is # to calculated CRC THEN 
ignore frame; 

ELSE 

received frame (buf Addr, bufLen, 

rcvdChanID, 

reception type {, group Addr}) 

END; 
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PROCEDURE receive LAP frame 

{LAP takes the bits presented to it from the physical 
layer and transfers a valid frame to PTP} 

BEGIN 

LAP allocates buffer for next incoming frame; 

LAP receives frame from physical layer; 
check DLAddr; 

IF frame is not for this LANA THEN 
ignore frame; 
reallocate buffer 
ELSE 

check CRC; 

IF CRC of frame is # to calculated CRC THEN 
ignore frame 
ELSE 

received frame (bufAddr, bufLen, 

rcvdChanID, 

reception type {, group Addr}) 

END; 


PROCEDURE received frame (bufAddr, bufLen, 

rcvdChanID, receptionType {, 
group Addr}) 

{send data buffer from link to network layer and 
interpret network layer header and trailer. Pass data 
on to transport layer} 

BEGIN 

check packet type 
IF type is route tear down THEN 

notify network entity to erase route from 
memory; 

ELSE IF type is connection data THEN 

set NCID to nextLID field in packet’s trailer; 

received call (PID, bufAddr, bufLen) 

ELSE IF type is route completion THEN 
set nextLID = received packet’s trailer’s 
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prevID field; 

set nextNodelD to received packet’s prevNodelD 
field; 

received call (PID, bufAddr, bufLen) 

{connection established} 

ELSE IF type is discovery THEN 

IF destNodelD field does not match adapter’s 
permanent node name or any currently enabled group 
address THEN 
ignore packet; 

ELSE 

validate packet using discovery table 
IF packet is a duplicate THEN 
ignore packet 

ELSE IF packet is a datagram type THEN 

received call (PID=1, bufAddr, bufLen) 

ELSE 

{packet is route establishing type} 
allocate entry in network connection 
table; 

set NCID to index of this entry; 
set entry’s nextLID to packet’s 
prevLID; 

set entry’s nextNodelD to source 
permanent node name; 

received call (PID=0, bufAddr, bufLen) 

END; 
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Packet Reception Procedures 

This section describes the receipt of packets by the 
transport and session layer entities from the network 
layer entity. At this point, the packet has been received 
and determined to be for this node. 


PROCEDURE received call (PID, bufAddr, bufLen) 

BEGIN 

IF protocolID = 1 {datagram} THEN 
CASE packet type OF 

user datagram: 

search for sender’s name in remote name 
table; 

IF sender’s name is not found THEN 

set unknown remote name indicator 

{unable to determine sender’s name} 

IF datagram receive specific is 
specified THEN 

check recipient alias number in 
datagram message; 

IF recipient alias number in datagram 
message is same as local alias number 
THEN 

set receive completed indicator 

{datagram receive to specific 
alias satisfied} 

ELSE 

reset receive completed indicator 

{datagram receive not satisfied, 
continue to wait} 

ELSE 

set receive completed indicator 

{datagram receive to any alias 
satisfied} 

transfer datagram data to user buffer; 
return actual length of transfer to user 

return local alias no to user; 

IF unknown remote name indicator 

is set THEN 
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return unknown remote name status to 

user; 

{datagram received, unable to 
determine sender’s name} 

ELSE 

return sender’s name to user 
IE size of user buffer is smaller than 
received datagram THEN 
return 

message incomplete status to user; 

{datagram received, unable to transfer 
entire message} 

ELSE 

return command completed status to user 

{datagram received} 

name query: 

IE name is stored in local name table THEN 

send name query response packet to 

sender; 

ELSE 

ignore packet; 

name query response: 

check total number of query response 

packets received; 

IF one query response packet is received 

THEN 

enter information to remote name 
table; 

send datagram to remote node; 

return command completed status to 

user; 

ELSE 

send name conflict packets to 

nodes that responded with 

query response packet; 

return unknown remote name status to 

user; 

name claim: 

IF name is in local name table THEN 
send name claim response packet to 
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sender; 

ELSE 

ignore packet; 
name claim response: 

return alias name in use status to user; 

status request: 

IF alias name is * THEN 

IF local alias table is empty THEN 

return no valid aliases status 

to user; 

ELSE 

REPEAT 

search for alias name in local alias 
table; 

get session status is session table; 
return session status to user 
UNTIL all alias names are found; 
return actual length of session 
status; 

IF size of user buffer is smaller than 
session status THEN 
return 

message incomplete status to user; 
ELSE 

return command completed status to 

user; 

ELSE 

search for alias name in local alias 
table; 

IF alias name is found THEN 

get session status in session table; 
return session status to user; 
return actual length of session 
status; 

IF size of user buffer is smaller than 
session status THEN 
return 

message incomplete status to user; 

ELSE 

return command completed status to 

user; 
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ELSE 

return illegal alias name status to 

user; 

status response: 

IE status response packet is received 

within the timeout interval THEN 
get configuration parameters and 
status of responding adapter; 
return configuration parameters and 
status; 

return actual length of configuration 
parameter and status; 

IF size of user buffer is smaller than 
the configuration parameter and status 
THEN 

return message incomplete status 
to user; 

ELSE 

return command completed status to 

user; 

ELSE 

return command timed out status to 

user; 

END CASE; 
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IF protocolID = 0 {session} THEN 
CASE packet type OF 

open request: 

IF open request packet is a duplicate THEN 

return appropriate response again (open 

ack or open nack) to sender 

ELSE 

IF specified service exists and can 
provide resources THEN 
send open ack to sender; 
notify RSP user with 

new connection from remote call 

ELSE 

send open nack with reason; 
open ack: 

validate that open ack packet was expected 
(open request was issued with the given 
source connection ID); 

IF open ack was not expected THEN 
ignore packet 
ELSE 

return user’s call successfully with 
connection ID; 

open nack: 

return error indication to user’s open call; 
return error reason; 

ack: 

remove the acknowledged packet form the 
retransmit queue; 

update the last acknowledged variable; 
nack: 

remove all acknowledged packets form the 
retransmit queue; 

retransmit all unacknowledged packets (up 
to the current set window size value); 
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close: 

IF close packet received from close 
initiator THEN 

send close packet to close initiator; 

ELSE 

{close packet received form close 
non-initiator} 

acknowledge receipt of close packet; 

send closed packet; 

notify user that connection is closed; 

closed: 

notify user that connection is closed; 

session request: 

REPEAT 

IF passive open specified is specified THEN 

check source of session request packet; 

IF source of session request 

packet is same as remote name THEN 

set session request completed 

indicator; 

{passive open specified satisfied} 

ELSE 

reset session request completed 

indicator; 

{passive open not satisfied, 
continue to wait} 

ELSE 

set session request completed indicator 

{passive open any satisfied} 

UNTIL session request completed indicator 

is set; 

send session accept packet to source; 

set session established indicator in 

session table; 

return source of session request packet to 

user; 

return local session no to user; 

return command completed status to user 

{session established} 
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session accept: 

set session established indicator in 

session table; 

return local session no to user; 

return command completed status to user 

{Session established} 

session reject: 

return session open rejected status to user; 

session data: 

IF session data is received within the 
timeout interval for session received THEN 
transfer session data to user buffer; 
return actual length of transfer 
to user; 

IF size of user buffer is smaller than 
received session data THEN 
return 

message incomplete status to user; 

ELSE 

return command completed status to 

user; 

ELSE 

return command timed out status to user 

{session data received}; 

END CASE; 

END 
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Appendix D. Adapter BIOS 


9 

10 


0000 

0028 

0028 01 ( 

???? 

1 

002 A 01 I 

I 

002C 


TITLE LANA ROS POD 


NETWORK ADAPTER DIAGNOSTICS 

THIS CODE IS ACCESSED AT POWER ON AND DURING SOFT RESETS. THE 
ADAPTER IS TESTED FOR PROPER OPERATION. IF A ERROR IS DETECTED 
A MESSAGE IS DISPLAYED TO INDICATE THE TYPE OF FAILURE. 


LANA ADDRESSING CARD 
(SR) STATUS REGISTER 360 
(PR) PARAMETER REGISTER 361 
(DR) DATA REGISTER 362 
(HIR) HOST INTERFACE REG 363 
BL CONTAINS DELTA 00 


INTERRUP VECTORS 


DATA SEGMENT AT 0 
ORG 0AH*4 

INTR_2 DW 1 DUP (? ) 


; I NT 2 VECTOR ADDRESS 
; CONTAINS OFFSET OF I NT 2 HANDLER 


DW 


DUP (?) 


; CONTAINS CS FOR 2 


ORG 0BH*4 


; INT 3 VECTOR ADDRESS 


002C 

002E 

004C 

004C 

004E 

0060 

0060 

0062 

0070 

0070 


01 I 

1 

01 ( 

1 

01 [ 

] 

01 I 

1 

01 I 

1 

01 [ 

] 


0170 

0170 01 [ 

???? 

1 

0172 01 ( 

1 


I NTR_3 


DW 1 DUP ( ? ) 

DW 1 DUP (?) 

13H*4 

DW 1 DUP (?) 

DW 1 DUP (?) 

18H*4 

DW 1 DUP (?) 


DW 


DUP (?) 


ORG 

TICK_INT 

ORG 

LANA_B I 0S_ I NT 


1CH*4 

LABEL WORD 
05CH*4 

DW 1 DUP (?) 


DW 


DUP (?) 


; CONTAINS OFFSET OFF INT 3 HANDLER 

CONTAINS CS FOR INT 3 


; IPL 


vector address 


; INT 1C TIMER TICK 

;LANA BIOS SOFT INT 

; CONTAINS OFFSET OFF 5C 

.■CONTAINS CS 


81 

82 

83 

84 

85 

86 

87 

88 


1000 

1000 

1000 01 


RAM WORK AREA 


ORG 

RAM_AREA 
I NT_OCCUR? 


1000H 

LABEL BYTE 
DB 1 DUP (?) 


; 80= I NT 


1001 

1002 

1003 

1004 

1005 

1006 

1007 

1008 

1009 


1 

01 [ 

1 

01 I 

?? 

1 

01 I 

) 


01 ( 

01 ( 

01 ( 

01 ( 

01 [ 

01 I 


INTS_ACTIVE 


1 DUP ( ? ) 


COUNT 

DATA_XFER 


FAIL_FLAG 

RF_TEST 

SAVE_MASK 

SAVE_MASKA 

SAVE_TICK_I 


INT 


DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DW 1 DUP (?) 


; CONTAINS THE INT LEVELS FOUND ACTIVE 

; 08= I NT 3 04= I NT 2 

;USE FOR DEBUG 

;DMA WRITES HERE 

;2ND BYTE DMA 

;80=HARDWARE FAILURE 

;80=H0T RF TEST IN PROCESS 

; I MR MASK FOR 1ST INT CHIP 

;IMR MASK FOR 2ND INT CHIP 

; OFFSET OF TICK HANDLER IN BIOS 
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100B 01 [ 

1000 01 [ 

100F 01 ( 

1010 01 [ 

1011 01 [ 

1012 01 ( 

1013 01 ( 

1014 01 [ 

1015 01 [ 

1016 01 t 

1018 01 [ 

101A 01 t 

101C 01 ( 

101E . 01 [ 

101F 01 ( 


202 

203 

204 

205 

206 

207 

208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 


008F 

0000 

0003 

0004 
OOOA 
0082 
OOFB 
00F7 
00F3 
00 FD 
0020 
008B 
008A 
008E 
0088 
0020 
0021 
00A1 
0010 
0028 
002C 
004C 
0170 
0218 
04A2 
04A3 
OOOC 
008C 

0360 

0361 
OOOE 
00 FC 

= 0362 
0363 
0085 
0004 
0080 
FFFF 
0333 
0089 
0222 
OOFE 


TICKS 

T_0_FLAG 

PC_ID 

; — INT 2 = BIT 
TEMP_INT 

LANA_0_INT 

LANA_1_INT 

l-ANA_1 .ACTIVE 

NO.SYNC 

;SAVE AREA FOR 
SAVE_INT2 

SAVE. I NT3 

DMA.DATA 

RAM.AREA.END 
DATA ENDS 


DW 1 DUP (?) 

DW 1 DUP (?) 

D8 1 DUP (?) 

DB 1 DUP (?) 

2,--INT 3 = BIT 3 
DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

POST VECTORS 
DW 1 DUP (?) 

DW 1 DUP (?) 

DW 1 DUP (?) 

DW 1 DUP (?) 

DB 1 DUP (?) 

DB 1 DUP (?) 

LABEL BYTE 


.-CODE SEG OF BIOS 

; COUNTER FOR TIMER TICKS 

; GROSS TIME OUT FLAG=80=FA1L 

; I D BYTE 

; HOLDS CURRENT ACTIVE INT LEVEL 

; CONTAINS ACTIVE INT LEVEL FOR LANA 0 

; CONTAINS ACTIVE INT LEVEL FOR Lj\NA 1 

;0=LANA NOT ACTIVE 

;80 = NOT IN SYNC FAILURE 

; OFFSET INT 2 

; SEGMENT 

; OFFSET INT 3 

; SEGMENT 

;MOV DMA DATA HERE 

;MOV SECOND BYTE HERE 


EQUATES 


ANALOG. FAIL EQU 
DMA EQU 
DMA_CHAN3 EQU 
DMA.MASK EQU 
DMA.SINGLE.MASK EQU 
DMA_3_PAGE EQU 
ENABLE. I NT2 EQU 
ENABLE. I NT3 EQU 
ENABLE. I NT2.3 EQU 
ENABLE. I NT9 EQU 
EOl EQU 
FAI L.ERR.REPORT EQU 
FAIL.GO EQU 
HOT.RF EQU 
HOST.DETECT.HIC EQU 
INTAOO EQU 
INTA01 EQU 
INTB01 EQU 
INTS.FLAG EQU 
INT2_VECT EQU 
INTS.VECT EQU 
INT13_VECT EQU 
INT5C_VECT EQU 
INT86.VECT EQU 
LANA.O.STATS EQU 
LANA.1.STATS EQU 
MASK.IRQ2.3 EQU 
NO.CRD.PRESENT EQU 
STATUS.REG EQU 
PARAMETER.REG EQU 
PC I D.ADD EQU 
PC3 EQU 
DATA.REG EQU 
HOST.INTR.REG EQU 
HOST.FAIL EQU 
RESET EQU 
RESET.INT.REQ EQU 
ROS.CODE EQU 
RF.COUNT EQU 
SYNC.FAILED EQU 
T.O.CNT EQU 
TIMER.INT.ENA EQU 


8FH 

OOH 

03H 

04H 

OAH 

82H 

OFBH 

0F7H 

0F3H 

OFDH 

20H 

8BH 

8AH 

8EH 

88H 

020H 

021H 

0A1H 

10H 

028H 

02CH 

04CH 

170H 

218H 

4A2H 

4A3H 

OCH 

8CH 

360H 

361H 

OEH 

OFCH 

362H 

363H 

085H 

04H 

80H 

OFFFFH 

333H 

89H 

222H 

OFEH 


ANALOG FAILURE AS REPORTED BY LANA 

BASE ADDRESS OF DMA 

SELECTS CHAN 3 DMA 

BIT FOR MASKING OF DMA REQUESTS 

ADD OF SINGLE MASK 

PAGE REG FOR DMA CHAN 3 

USE FOR I MR TO ENABLE INT REQ 2 

USE TO ENABBLE INT 3 


ENABLE GENERAL INTERRUPTS 

CMD 41 DID NOT REPORT CORRECTLY 

FAILED TO GET A GO BIT 

FLAG FOR POSSIBLE HOT CARRIER 

ERROR NUMBER FOR HOST DETECTING HIC 

CHIP 1 

CHI P 1 

INT LEVEL 3 ACTIVE 

PHYSICAL ADD FOR INT VECTOR 2 (A*4) 

" " " " "3 (B*4) 

•I •• n I. •• i3(i3h*4) 

" " " '• " 5C(5CH*4) 

" " " " " 86(86H*4) 

OFFSET FOR BIOS STATUS LANA 0 
OFFSET FOR BIOS STATUS LANA 1 
MASK FOR DISABLE INT REQ 2,3 
ERROR CODE FOR NO CARD PRESENT 
STATUS REGISTER FIRST CARD 

OFFSET FOR PC lOENTY 
PC3 ID 


;FLAG FOR HOST TEST FAIL 
;RESET BIT IN HIR 

;HC = 1 IN STATUS REG =RESET REQ’S 

; POINTER INTO ROS 

;45 SEC HOT RF DELAY 

I WE DID NOT GET IN SYNC 

;30 SECS (18.2 * 30 = 546 = 222H) 

; ENABLE MASK FOR INT 0 - TIMER 
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253 

254 

255 

256 

257 

258 

259 

260 
261 
262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 
281 
282 

283 

284 

285 

286 

287 

288 

289 

290 

291 

292 

293 

294 

295 

296 

297 

298 
299 


316 

317 

318 

319 

320 


324 

325 

326 

327 

328 

329 

330 


347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 

358 

359 

360 


364 

365 

366 

367 


0000 

0000 55 

0001 AA 

0002 10 

0003 

0003 EB 2D 

0005 36 33 36 30 37 31 

35 20 28 43 29 20 
43 4F 50 59 52 49 
47 48 54 20 20 49 
42 40 20 43 4F 52 
50 2E 20 31 39 38 
34 

002A 30 34 2F 31 39 2F 

38 34 


0032 

0032 

0032 FB 

0033 33 CO 
0035 8E 08 
0037 8E CO 

0039 FC 

003A BF 1000 R 
0030 B9 0021 

0040 F3/ AA 

0042 26: A2 04A2 

0046 26: A2 04A3 

004A 

004A B8 FFFF 
0040 8E 08 
004F BB OOOE 
0052 8A 07 

0054 06 

0055 IF 

0056 A2 1010 R 
0059 E4 21 
005B A2 1007 R 


005E E8 0708 R 
0061 E8 07FF R 
0064 E8 088E R 
0067 E4 21 
0069 EB 00 
006B 24 FE 

0060 E6 21 


006F 33 OB 

0071 BO 04 
0073 BA 0363 

0076 EE 

0077 BA 036B 
007A EE 
007B B9 OOFF 
007E 

007E E2 FE 


0080 BA 0363 
0083 E8 06F8 R 

0086 73 03 

0088 E9 014B R 
008B 


008B E8 079C R 
008E EB 13 


0090 

0090 BA 0363 
0093 03 03 

0095 E8 06F8 R 

0098 73 03 

009A E9 01 4B R 


0090 


0090 E8 07AD R 
OOAO E8 0708 R 


EXTRN MAIN: NEAR 
EXTRN HARD_FILE:NEAR 
EXTRN REM_IPL:NEAR 


;BIOS HANDLER FOR SOFT I NT 5C 
; INTERCEPT HARD FILE SOFT I NT 13 
jBIOS HANDLER FOR I PL 


PUBLIC RAS_START 


NETWORK SEGMENT PARA PUBLIC 

ASSUME CS: NETWORK 
ASSUME DS:OATA 
ASSUME SS: NOTH I NO 
ASSUME ES: NOTHING 


'CODE' 


CODE START 


HOST_ INTERFACE PROC FAR 
MOD_ID OB 055H 

OB OAAH 

DB 160 

START: 

JMP SHORT HI1 

DB '6360715 (C) COPYRIGHT 


;GENERIC BIOS HEADER 
;# OF 512 BYTE BLOCKS 
;JMP TO START OF CODE 
IBM CORP. 1984' ; COPYRIGHT NOTICE 


DB '04/19/84' 


RAS_START: 

H1 1 : 

ST I ; ENABLE INTERRUPTS 

XOR AX, AX ; ESTABLISH SEG REG 

MOV OS, AX 

MOV ES,AX 

CLD 

MOV 01, OFFSET RAM_AREA ;GET STARTING RAM LOCATION 

MOV CX, (RAM_AREA_END-RAM_AREA) + 1 ; RAM SIZE 

REP STOSB ; CLEAR THE WORK AREA 

MOV ES: LANA_0_STATS, AL 

MOV ES;LANA_1_STATS,AL 


MOV AX, ROS_CODE 

MOV OS, AX 

MOV BX, PC_ID_ADD 

MOV AL, [ BX ) 

PUSH ES 

POP OS 

MOV PC_ 1 0, AL 

IN AL, INTA01 

MOV SAVE_MASK,AL 


;ROS POINTER FOR OS 


;GET PC INFO 
;DS=ES 

;SAVE IT FOR LATER USE 
; IMR 1ST I NT CHIP 


-INSURE I NT 2,3 MASKED OFF 


CALL MASK_INT_2_3 

CALL SAVE_INT_VECT 

CALL SET_UP TIME_TICK 

IN AL, INTA01 

JMP SHORT $ + 2 

AND AL,TIMER_INT_ENA 

OUT INTAOl.AL 


MASK I NT 2 & 3 
SAVE 2 8e 3 

POINT TIME TICK TO LANA 

GET IMR 

DELAY 

ALLOW I NT 0 TO RUN 
WRITE THE MASK 


■RESET LANA CARDS- 


SI; 


xor bx,bx 

MOV AL, RESET 

MOV DX, HOST_ I NTR_REG 

OUT DX,AL 

MOV DX,HOST_INTR_REG + 8 

OUT DX,AL 

MOV CX,OFFH 

LOOP SI 


RESET BIT FOR HIR 
ADD OF FIRST CARD 
RESET 1ST CARD 
ADD OF 2ND CARD 
RESET 2ND CARD 
DELAY TIME 

; DELAY 


;LANAO PRESENT? 


MOV OX,HOST_INTR_REG 

CALL LANA_PRESENT? 


;ADD FOR LANA 0 
;SEE IF INSTALLED 


S2: 


JNC S2 

JMP ANY_MORE_LANAS 


;JMP LANA 0 INSTALLED 
;SEE IF LANA 1 INSTALLED 


;LANAO ADAPTER INSTALLED 

; --REMOVE RESET FROM LANA 0 PRIMARY CARD 


CALL REMOVE_RESETO 

JMP SHORT RR1A 


; --REMOVE RESET FROM LANA 1 

LANA1_PRESENT?: 

MOV DX, HOST_ I NTR_REG 

ADD DX, BX 

CALL LANA_PRESENT? 

JNC LANAI _RESET 

JMP ANY_MORE_LANAS 


;D0 THE DOUBLE RESET TO LANAO 
;TEST LANAO ADAPTER 


; HIR REG 
; OFFSET FOR LANAI 
;LANA 1 INSTALLED? 

;LANA 1 INSTALLED, REMOVE RESET 
; COMMON HANDLER 


LANA1_RESET: 

; LANAI 

CALL 

CALL 


INSTALLED TEST ADAPATER 
REM0VE_RESET1 
MASK_ I NT_2_3 


;D0 THE DOUBLE RESET TO LANAI 
;TURN OF I NTS 


TEST INTERFACE TO LANA 


Adapter BIOS D-3 



402 

403 

404 

405 

406 

407 

408 

409 

410 

411 

412 

413 

414 

415 

416 

417 

418 

419 

420 

421 

422 

423 

424 

425 

426 

427 

428 

429 

430 


434 

435 

436 

437 

438 

439 

440 

441 

442 

443 

444 

445 

446 

447 

448 

449 

450 

451 

452 
453- 

454 

455 

456 

457 

458 

459 

460 

461 

462 

463 

464 

465 

466 

467 

468 

469 

470 


474 

475 

476 

477 

478 

479 

480 


00A3 

00A3 E8 02 F8 R 
00A6 73 23 


00A8 80 3E 100F R 80 

OOAD 74 08 


OOAF BO 88 
00B1 E8 070F R 
00B4 E9 014B R 

00B7 

00B7 80 3E 1015 R 80 

OOBC 75 00 


OOBE E8 02DF R 
00C1 72 33 


00C3 BO 89 
00C5 E8 070F R 
00C8 E9 014B R 


OOCB 

OOCB BA 0360 
OOCE 03 D3 
0000 

0000 EC 

0001 A8 01 

0003 75 OF 

0005 80 3E 100F R 80 

OODA 75 F4 


OODC BO 8A 
OODE E8 070F R 
00E1 EB 68 90 


00E4 


00E4 BA 0361 
00E7 03 03 

00E9 EC 
OOEA 3C 41 
OOEC 74 08 


OOEE BO 8B 
OOFO E8 070F R 
00F3 EB 56 90 


00F6 

00F6 E8 08FE R 
00F9 BA 0361 
OOFC 03 03 
OOFE EC 


OOFF 50 
0100 BA 0360 
0103 03 03 

0105 BO 00 

0107 EE 

0108 58 


0109 3C 80 
010B 74 11 


0100 3C 8E 
010F 75 08 


0111 E8 0617 R 

0114 73 08 

0116 EB 33 90 


CALL H I FT_TEST 
JNC PRIME_CMD 


;TEST THE HIF PLA 

;JMP NO ERROR IN HIF TEST 


; INTERFACE TEST FAILED 


CMP T_0_FLAG,80H 

JZ I N_SYNC? 

;H0ST DETECTED A DATA FAILURE 
;N0 INTERROGATION OF CMD 41 

MOV AL,HOST_DETECT_HIC 

CALL PC_ERROR 

JMP ANY_MORE_LANAS 

I N_SYNC? : 

;DID LANA GET IN SYNC 
CMP N0_SYNC,80H 

JNZ PRIME_CMD 


;TIME OUT OCCUR? 

;JMP YES 

-NO TIME OUT & CARRY SET 


FAILURE FLAG 
DISPLAY 30XX OR 31XX 
ANY MORE FOR TEST? 


;IS THE FAILED TO SYNC FLAG SET? 
;JMP IF IT DID GET IN SYNC 


;DID NOT SYNC IN-ARE GO BIT AND CMD 41 ACTIVE 
; I F YES LANA HAS STATUS TO REPORT 


CALL G0_BIT_CMD_41 ;RETURN WITH CF SET IF BOTH ACTIVE 

JC P_C4 ;JMP ACTIVE-GET 2ND BYTE OF CMD 41 


; FA I LED TO SYNC IN AND NO GO BIT ACTIVE 
MOV AL,SYNC_FAILED ; 

CALL PC_ERROR ;GO DISPLAY ERROR 

JMP ANY_MORE_L^NAS ;SEE IF ANY MORE ADAPTERS TO TEST 


" ” " " " ukW for’ 'primary’ CMd'4i”|n'it’|aL’iZAt16n'c6mpLeTe’ 


PRIME_CMD; 

MOV OX, STATUS_REG 
ADD OX, BX 

P_C1 : 

I N AL. OX 

TEST AL,01H 

JNZ P_C2 

CMP T_0_FLAG,80H 

JNZ P_C1 


•OFFSET 

;GET THE STATUS REG 
; I S THE GO BIT ON 
;JMP GO ON 

•JMP NO TIME OUT 


;TIME OUT AND NO GO BIT 


MOV AL, FAIL_GO 

CALL PC_ERROR 

JMP ANY_MORE_ LANAS 


NEVER GO A GO BIT 
;DISPLAY 30XX OR 31XX 


;GO BIT ACTIVE CHECK CMD 

MOV DX. PARAMETER_REG 
ADD DX.BX 

IN AL,DX 

CMP AL,041H 

JZ P_C4 

;GO BIT AND NOT CMD 41 


MOV AL, FAI L_ERR_REPORT 

CALL PC_ERROR 

JMP ANY_MORE_LANAS 


;CMO 41 REPORT FAILURE 
;30XX OR 31XX 


WAS LANA SELF TEST SUCCESSFUL 


CALL STOP_TIMER 
MOV DX, PARAMETER_REG 

ADO OX, BX 

IN AL,DX 


GROSS TIME OUT INACTIVE 
OFFSET 

GET 2ND BYTE OF PARAMETER REG 


; RETURN STATUS TO CMD 


PUSH AX 

MOV DX,STATUS_REG 
ADD DX, BX 

MOV AL,00 

OUT DX,AL 

POP AX 


SAVE CMD 41 INFO 
ADD OFFSET 

CC BITS = 0 AND GO = 0 
PASS IT 


;WHAT WERE THE RESULTS 


CMP AL,80H 

JZ P_C5 


;80=SUCCESSFUL 
;JMP LANA POST OK 


;LANA SELF TEST UNSUCCESSFUL - TEST FOR POSSIBLE HOT RF 


CMP AL,HOT_RF ; 

JNZ P_C4A ;JMP NOT HOT RF 


;GO TEST RF 


CALL HOT_RF? 

JNC P_C5 

JMP ANY_MORE_LANAS 


TEST RF IF HOT DISPLAY 3X41/42 
RF NOT HOT ,THEN CF NOT SET 
IF RF NOT HOT I NIT LANA 
OR 3X41 OR 3X42 


485 

486 0119 

487 


488 

489 

490 

491 

492 

493 

494 

495 

496 

497 

498 

499 

500 

501 

502 

503 

504 


0119 E8 070F R 
one EB 2D 


011E 


01 IE BO 80 
0120 83 FB 00 

0123 75 15 


0125 26: A2 04A2 


;GO SORT THE ERRROR 

CALL PC_ERROR 

JMP SHORT ANY_MORE_LANAS 


;GO SORT THE ERROR AND DISPLAY IT 
; CHECK FOR ANOTHER LANA 


"" 'ADAPTER'tEst'oK’-' POSt'sTATUs' info’ FOr’nH’bIOs’ 


P_C5: 

UP DATE BIOS STATUS— LANA X OK— 


MOV AL, 80H 

CMP BX,0 

JNZ P_C7 


PRESENT BIT 
THIS LANA 0 ? 
JMP NO 


;LANA 0 BIOS STATS 


MOV ES : LANA_0_STATS, AL 


;BIOS INFO FOR LANA 0 


D-4 Adapter BIOS 



528 

529 

530 


534 

535 

536 

537 

538 

539 

540 

541 

542 

543 

544 

545 

546 

547 

548 

549 

550 


568 

569 

570 


574 

575 

576 

577 

578 

579 

580 

581 

582 

583 

584 

585 

586 

587 


602 

603 

604 

605 

606 

607 

608 

609 

610 


614 

615 

616 

617 

618 

619 

620 


624 

625 

626 

627 

628 

629 

630 


0129 AO 1011 R 
012C A2 1012 R 
012F 08 06 1001 R 

0133 32 CO 

0135 A2 1011 R 
0138 EB 11 
013A 


01 3A 26: A2 04A3 
01 3E AO 1011 R 
0141 A2 1013 R 
0144 A2 1014 R 
0147 08 06 1001 R 


014B 

014B 83 FB 00 

014E 75 06 

0150 BB 0008 
0153 E9 0090 R 


0156 

0156 26: F6 06 04A2 80 

015C 75 16 

01 5E 26: F6 06 04A3 80 
0164 75 OE 


0166 80 3E 1005 R 80 

016B 74 OA 


0160 BO 8C 
016F E8 070F R 
0172 EB 03 

0174 

0174 E8 081C R 
0177 

0177 33 DB 

0179 E8 08DC R 

01 7C BB 0008 
017F E8 08DC R 

0182 

0182 E8 07C0 R 
0185 E8 07CF R 
0188 

0188 E8 0198 R 
018B CB 
018C 


018C 

018C BA 0360 
018F 03 03 

0191 EC 

0192 EB 00 
0194 OC 80 

0196 EE 

0197 C3 

0198 

0198 

0198 FC 

0199 33 CO 

019B BF 1000 R 
019E B9 0021 
01A1 F3/ AA 

01A3 C3 

01A4 

01A4 

01A4 50 

01A5 53 

01A6 

01A6 2E: 8A 04 

01A9 46 

01AA 50 
01AB E8 01B6 R 
01AE 58 
01AF 3C OA 
01B1 75 F3 

01B3 5B 
01 B4 58 
01B5 C3 
01 B6 

01 B6 

01 B6 B4 OE 
01 B8 B7 00 
01BA CD 10 
01BC C3 
01BD 


01BD 33 30 30 31 OD OA 
01C3 33 30 30 32 00 OA 
01C9 33 30 30 33 OD OA 
01CF 33 30 30 34 OD OA 
0105 33 30 30 35 OD OA 
01DB 33 30 30 36 OD OA 
01E1 33 30 30 37 00 OA 
01E7 33 30 30 38 OD OA 
01 ED 33 30 30 39 OD OA 
01F3 33 30 31 30 OD OA 
01 F9 33 30 31 31 OD OA 


XOR 

MOV 

JMP 


AL.TEMP_INT 
LANA_0_ I NT, AL 
INTS_ACTIVE,AL 
AL,AL 

TEMP_INT,AL 

SHORT ANY_MORE_LANAS 


ACTIVE LEVEL FOR LANA 0 
SAVE I NT LEVEL ACTIVE 


CLEAR FOR TEST OF LANA ' 


;LANA 1 BIOS STATS 


MOV 

MOV 

MOV 

MOV 


ES: LANA_1_STATS, AL 

AL,TEMP_INT 

LANA_1_INT,AL 

LANA_1_ACTIVE,AL 

INTS_ACTIVE.AL 


HAVE BOTH LANAS BEEN TESTED? 


ANY_MORE_LANAS: 

CMP 

JNZ 

MOV 

JMP 


BX.O 

ALL_TESTED 

BX,08H 

LANA1_PRESENT? 


; IS OFFSET=0= LANA 0 
;JMP BOTH LANAS TESTED 
;0FFSET=8= LANA 1 
;G0 TEST LANA 1 


; ALL LANAS HAVE BEEN TESTED 


BYTE PTR ES:LANA_0_STATS,80H 
PR2 


;LANA 0 TEST SUCCESSFUL? 
;JMP YES TO PR2 


TEST BYTE PTR ES: LANA_1_STATS, 80H 

JNZ PR2 


;LANA 1 TEST SUCCESFUL? 
;JMP YES 


;N0 LANA I NIT, WAS ANY ERROR REPORTED? 


CMP FAIL_FLAG,80H ; 80=HARDWARE FAILURE 

JZ AP3 ;JMP ERROR REPORTED 

;N0 LANA IN IT, & NO ERR REPORTED, PRESENCE TEST FAILURE 


MOV AL,NO_CRD_PRESENT 

CALL PC_ERROR 

JMP SHORT AP3 

PR2: 

CALL SET_BIOS_INTS 

AP3: 

XOR BX, BX 

CALL SPECIAL_CLR 

MOV BX, 08H 

CALL SPECIAL_CLR 


; UNIQUE ERROR CODE 
;G0 DISPLAY ERROR CODE 


;G0 SET UP THE LANA BIOS INTERRUPTS 
;LANA 0 

; DISABLE ALL I NTS FROM LANA 0 
;LANA 1 

; DISABLE ALL I NTS FROM LANAI 


CALL RESTORE_TICK_VECTOR 

CALL REST0RE_INT2_3 

PR5: 

CALL CLEAR_WORK_AREA 
RET 


HOST_ INTERFACE ENDP 


•RESTORE I NT VECTORS & I NT MASKS 
;G0 CLEAR RAM USED IN TEST 
; RETURN TO CALLING POST 


; PROCEDURES 


CLR_LANA_ I NTS 
MOV 
ADD 
IN 
JMP 
OR 
OUT 
RET 

CLR_LANA_INTS 


CLEAR_WORK_AREA 


PROC NEAR 
DX, STATUS_REG 
OX,BX 
AL,DX 

SHORT $ + 2 

AL,RESET_INT_REQ 

DX,AL 


cLear'any’ Lana’ int' requests' ” " " 

ADD OFFSET 

GET THE STATUS REG 

DELAY 

OR IN BIT TO TURN OF I NT REQUESTS 
CLEAR I NT REQUEST FROM LANA CARD 


ENDP 


PROC 


NEAR 


; clears’ low’ ram’ used’ dur’i ng’ lana’ ’por’ 


CLD 

XOR 

MOV 

MOV 

REP 

RET 

CLEAR_WORK_AREA 


D I SPLAY 

PUSH 

PUSH 

D_1: 


DISPLAY ENDP 


D I, OFFSET RAM_AREA 
CX, ( RAM_AREA_END-RAM_AREA 
STOSB 

ENDP 

PROc” ” near” ” ” 


STARTING BYTE OF RAM WORK AREA 
;RAM SIZE 
CLEAR THE AREA 


DISPLAY A MESSAGE 


PUSH 

CALL 

POP 

CMP 


AL,CS: (SI 
SI 


] 


AL, 10 
D_1 
BX 
AX 


PUT CHACTER IN AL 

SAVE PRINT CHAR 
CALL VIDEO 10 
RECOVER PRINT CHAR 
WAS IT A LINE FEED? 
NO KEEP PRINTING 


PRT_HEX 


PRT_HEX 


PROC 

MOV 

MOV 


NEAR ; DISPLAY CHAR IN AL 

AH, 14 

BH,0 ; 

10H ;CALL VIDEO_IO 



PRIMARY CARD-- 


M1 DB 

M2 DB 

M3 OB 

M4 DB 

M5 DB 

M6 DB 

M7 DB 

M8 DB 

M9 DB 

M10 DB 

Ml 1 DB 


'3001', 13, 10 
'3002', 13, 10 
’3003’, 13, 10 
'3004', 13, 10 
'3005', 13, 10 
'3006' ,13,10 
'3007', 13, 10 
'3008', 13, 10 
'3009', 13, 10 
'3010', 13, 10 
'3011 ' ,13, 10 


CPU FAILURE 

ROS FAILURE 

ID FAILURE 

RAM FAILURE 

HIC FAILURE 

-I- 12V FAILURE 

DIGITAL LOOPBACK FAILURE 

HOST DETECTED HIC FAILURE 

SYNC FAIL & NO GO BIT 

HIC TEST OK & NO GO BIT 

GO BIT & NO CMD 41 


Adapter BIOS D-5 



632 

633 

634 

635 

636 

637 

638 

639 

640 

641 

642 

643 

644 

645 

646 

647 

648 

649 

650 

651 

652 

653 

654 

655 

656 

657 

658 

659 

660 
661 
662 

663 

664 

665 

666 

667 

668 

669 

670 


674 

675 

676 

677 

678 

679 

680 


684 

685 

686 

687 

688 

689 

690 

691 

692 

693 

694 

695 

696 

697 


706 

707 

708 

709 

710 


715 

716 

717 

718 

719 

720 


734 

735 

736 

737 

738 

739 

740 

741 

742 

743 

744 

745 

746 

747 

748 

749 

750 


01FF 33 30 31 32 00 OA 
0205 33 30 31 33 00 OA 
0208 33 30 31 35 00 OA 


0211 33 30 34 31 00 OA 
0217 33 30 34 32 00 OA 


0210 33 31 30 31 00 OA 
0223 33 31 30 32 00 OA 
0229 33 31 30 33 00 OA 
022F 33 31 30 34 00 OA 
0235 33 31 30 35 00 OA 
0238 33 31 30 36 00 OA 
0241 33 31 30 37 00 OA 
0247 33 31 30 38 00 OA 
0240 33 31 30 39 00 OA 
0253 33 31 31 30 00 OA 
0259 33 31 31 31 00 OA 
025F 33 31 31 32 00 OA 
0265 33 31 31 33 00 OA 
0268 33 31 31 35 00 OA 

0271 33 31 34 31 00 OA 
0277 33 31 34 32 00 OA 


0270 


0270 89 0004 

0280 03 CO 

0282 8A C8 
0284 80 El OF 

0287 24 FO 

0289 03 C7 

0288 12 CD 

0280 E6 OC 
028F EB 00 
0291 E6 06 
0293 8A C4 
0295 EB 00 

0297 E6 06 
0299 EB 00 

0298 8A Cl 

0290 E6 82 
029F C3 
02A0 

02A0 


02A0 83 FB 00 

02A3 74 21 


02A5 26: F6 06 04A2 80 

02AB 74 19 

02AD F6 06 1012 R 08 
0282 75 09 


0284 E4 21 
0286 24 F7 

0288 EB 00 
02BA E6 21 
02BC C3 

02BD 


0280 E4 21 
02BF 24 FB 
02C1 EB 00 
02C3 E6 21 
02C5 C3 
02C6 

02C6 E4 21 
02C8 24 F3 

02CA EB 00 
02CC E6 21 


02CE 80 3E 1010 R FC 
0203 75 09 

0205 E4 A1 
0207 A2 1008 R 
02DA 24 FD 
020C E6 A1 
02DE 
02DE C3 
02DF 

02DF 


02E9 BA 0361 
02EC 03 03 
02EE EC 
02EF 3C 41 
02F1 75 03 

02F3 F9 


M12 

06 

'3012', 13. 10 

CARD NOT PRESENT 


M13 

OB 

'3013', 13, 10 

DIGITAL FAILURE (FALL THRU) 


M15 

OB 

'3015', 13. 10 

ANALOG FAILURE 


M50 

OB 

'3041', 13, 10 

HOT CARRIER NOT ME 


M51 

OB 

'3042', 13, 10 

HOT CARRIER ME! 



SECONDARY CARD— 



M21 

OB 

'3101', 13. 10 

CPU FAILURE 


M22 

OB 

'3102'. 13. 10 

ROS FAILURE 


M23 

OB 

'3103', 13. 10 

ID FAILURE 


M24 

OB 

'3104', 13, 10 

RAM FAILURE 


M25 

OB 

'3105', 13, 10 

HIC FAILURE 


M26 

OB 

'3106', 13, 10 

+-12V FAILURE 


M27 

OB 

'3107', 13, 10 

DIGITAL LOOPBACK FAILURE 


M28 

OB 

'3108', 13, 10 

HOST DETECTED HIC FAILURE 


M29 

OB 

'3109', 13. 10 

SYNC FAILED & NO GO BIT 


M30 

OB 

'3110'. 13, 10 

HIC TEST OK ft NO GO BIT 


M31 

OB 

'3111', 13. 10 

GO BIT & NO CMD 41 


M32 

OB 

'3112', 13. 10 

CARO NOT PRESENT 


M33 

OB 

'3113', 13. 10 

DIGITAL FAILURE (FELL THRU) 


M35 

OB 

'3115', 13, 10 

ANALOG FAILURE 2ND CARD 


M60 

OB 

*3141', 13, 10 

HOT CARRIER NOT ME 


M61 

OB 

'3142', 13, 10 

HOT CARRIER ME! 


DMA ADDRESS 

PROC NEAR 

; CONVERT SEG AND OFFSET TO 

' 26 'Blf'AD 6 ' ' 




; CALLED WITH SEGMENT(CS OR 

OS) IN AX 




;& OFFSET IN 01 



MOV 

CX,4 

;CH=0,CL=R0L COUNT 



ROL 

AX. CL 

;AX=A<n : :00, 15: : 12> 



MOV 

CL.AL 

;CX=(0,0,A<3: :0,15: :12>) 



AND 

CL.OOFH 

;CX=SEG (0,0,0,A<19::16>) 



AND 

AL.OFOH 

;AX=SEG (A<15: :04>,0) 



ADD 

AX.DI 

;AX=REAL (A<15::00>) ieCX= 

SEGMENT ADJ 


ADC 

CL,CH 

;CX=REAL ( 0, 0, 0, A<19: : 16> ) 



OUT 

DMA + OCH.AL 

;SET THE BYtE F/F 



JMP 

SHORT $ + 2 

; DELAY 



OUT 

DMA + 6,AL 

;OUT A <07::00> 



MOV 

AL.AH 




JMP 

SHORT $ + 2 

; DELAY 



OUT 

DMA + 6,AL 

;0UT A<15::08> 



JMP 

SHORT $ + 2 

; DELAY 



MOV 

AL.CL 




OUT 

DMA 3 PAGE.AL 

;0UT A<19: : 16> 



RET 




DMA_ADDRESS 

ENDP 



ENABLE 

INTS 

PROC NEAR 




; 1 F LANAO ENABLE 1 NTS 2 & 3 & 9 



;IF LANAI DETERMINE INT USED BY LANAO & ENABLE THE REMAINII 

'IG INT 


;WITH 

LANAO MASKED OFF 




CMP 

BX,0 

;LANA 0 ? 



JZ 

EI3 

;JMP LANAO 



;WAS LANAO TEST SUCCESSFUL 



TEST 

BYTE PTR ES:LANA 

0 STATS, 80H : LANA 0 TEST SUCCESSFUL? 


JZ 

EI3 

;JMP NO-ENABLE ALL INTS 



TEST 

LANA 0 INT. 08 

; IS LANAO ON INT 3? 



JNZ 

EI2 

;JMP YES 



; LANAO 

ON INT 2 




; MASK 

OF INT REQ 2 




IN 

AL, INTA01 

;GET CURRENT MASK 



AND 

AL, ENABLE 1 NT3 

; ENABLE INT 3 



JMP 

SHORT $ + 2 




OUT 

INTAOl.AL 

;NEW MASK 3 ON 2 OFF 



RET 




EI2: 






; LANAt 

IS ON INT 3 




;MASK 

OF INT REQ 3 




IN 

AL, INTA01 

;GET CURRENT MASK 



AND 

AL, ENABLE INT2 

; ENABLE INT 2 



JMP 

SHORT $ + 2 




OUT 

INTAOl.AL 

;NEW MASK 2 ON 3 OFF 



RET 




EI3: 






; LANA{ 

ENABLE INT 2 & 3 




IN 

AL, INTA01 




AND 

AL, ENABLE 1 NT2 3 




JMP 

SHORT $ + 2 




OUT 

INTAOl.AL 




;0N A 

PC-3? 




CMP 

PC ID, PC3 

;FC=3 



JNZ 

EI4 

;JMP NOT = 3 



IN 

AL. INTB01 

;GET IMR 2ND CHIP 



MOV 

SAVE MASKA.AL 

;SAVE IT 



AND 

AL, ENABLE INT9 




OUT 

INTB01.AL 

; ENABLE 9 


EI4: 






RET 




ENABLE. 

INTS 

ENDP 



GO bU' 

CMO' 41 ’ 

PROC ' ' ' near' 

" " " ' Tl f' 66' B 1 1' ft' CMO' 41' then' set’ carry' flag 




;ELSE CLEAR CARRY FLAG 



MOV 

OX, STATUS REG 

;GET THE GO BIT FROM 



ADD 

DX.BX 

;THE STATUS REG 



IN 

AL.DX 




TEST 

AL,01 

;G0 BIT ON? 



JZ 

GBC1 

;G0 BIT NOT ACTIVE EXIT 



;G0 B 

T ACTIVE CHECK FOR CMO 41 



MOV 

OX, PARAMETER_REG 




ADD 

OX.BX 

;OFFSET 



IN 

AL.DX 




CMP 

AL,041H 

; IS IT INIT COMPLETE CMD? 



JNZ 

GBC1 

;JMP NO 



STC 


;G0 BIT ACTIVE AND CMD 41 



D-6 Adapter BIOS 



757 

758 

759 

760 

761 

762 

763 

764 

765 

766 

767 

768 

769 

770 


787 

788 

789 

790 

791 

792 

793 

794 

795 

796 

797 

798 

799 

800 
801 
802 

803 

804 

805 

806 

807 

808 


02F4 EB 01 
02 F6 

02 F6 F8 
02F7 

02F7 C3 
02 F8 


02F8 

02F8 32 E4 


02 FA 
02FF 
0302 

0304 

0305 
0307 


06 1002 R 80 

0360 

03 

10 

6A 


0309 FE 06 1002 R 
0300 BA 0362 

0310 03 03 

0312 BO AA 

0314 EE 

0315 EB 00 
0317 F6 DO 
0319 EE 


JMP SHORT GBC2 
CLC 


;G0 BIT*CMD 41 NOT ACTIVE 


THIS IS A COMMON PROC FOR LANA 0 ge 1 . THE PROC IS CALLED WITH A OFFSET 
OF 0 IN BX FOR LANA 0. AND A OFFSET OF 8 FOR LANA 1. THIS ROUTINE TESTS THE; 
HIF PLA REGISTERS AND CONTROL LOGIC. 

1. VERIFY THE STATUS OF REGISTERS FOLLOWING RESET 

2. WRITE/READ TO REGS AND VERIFY STATUS BITS 

THE FOLLOWING STEPS ARE DONE IN CONJUNCTION WITH THE LANA CPU 
1.SET I NT TO LANA (HOST SETS GO BIT) 

2. WAIT FOR I NT FROM LANA( LANA CLEARS GO BIT) 

3. DTI INT(DATA XFER LANA TO HOST) 

4. DRE I NT (DATA REG EMPTY I NT LANA) 

5. DATA XFER (HOST— >LANA I NT) 

6. DRE (LANA READS DATA CAUSES I NT TO HOST) 

7. WRITE TO LANA CAUSE I NT 

8. DMA XFER HOST --> LANA 2 BYTES 

9. DMA XFER LANA — > HOST TEST 2 BYTES DATA 

EXITS FROM PROC 

1. SUCCESSFUL ***RETURN TO CALLER WITH CARRY FLAG CLEAR 
2. FAILURE***RETURN TO CALLER WITH CARRY FLAG SET 


VERIFY STATUS REG 10H— 


MOV 

MOV 

ADD 

IN 

CMP 

JNZ 


COUNT, 80H 

DX, STATUS_REG 

DX,BX 

AL,DX 

AL, 10H 

HIFT_FAIL1 


INITIALIZE THE COUNT ( 80 ) 

ADD OFFSET FOR I/O ADDRESS 
GET STATUS REG 

ORE SHOULD BE THE ONLY ACTIVE BIT 
JMP NON COMPARE 


WRT/READ DATA REG— AND TEST DRF & DRE — 


INC 

MOV 

ADD 

MOV 

OUT 

JMP 

NOT 

OUT 


COUNT 

DX, DATA_REG 
DX,BX 
AL,OAAH 
DX,AL 

SHORT $ + 2 
AL 


DX,AL 


( 81 ) 

ADD OFFSET FOR I/O ADDRESS 
TEST BYTE 

WRITE FIRST BYTE AA 

DELAY 

AA TO 55 

WRITE 2ND BYTE 55 


TEST DRF & DRE— 


812 

813 

814 

815 

816 

817 

818 

819 

820 
821 
822 

823 

824 

825 

826 

827 

828 

829 

830 

831 

832 

833 

834 

835 

836 

837 

838 

839 

840 

841 

842 

843 

844 

845 

846 

847 

848 

849 

850 


854 

855 

856 

857 

858 

859 

860 
861 
862 

863 

864 

865 

866 
867 


872 

873 

874 

875 

876 

877 

878 

879 


031A BA 0360 
031D 03 D3 

031 F EC 
0320 3C 20 
0322 75 4F 


0324 FE 06 1002 R 
0328 BA 0362 
032B 03 D3 

032D EC 
032E 3C AA 
0330 75 41 


0332 BA 0360 
0335 03 D3 

0337 EC 

0338 3C 30 

033A 75 37 


033C BA 0362 
033F 03 D3 

0341 EC 

0342 3C 55 

0344 75 20 


0346 BA 0360 
0349 03 D3 

034B EC 
034C 3C 10 
034E 75 23 


0350 BA 0362 
0353 03 03 

0355 BO FF 

0357 EE 

0358 EB 00 

035A EC 
035B 3C FF 
035D 75 14 

035F BO 01 

0361 EE 

0362 EB 00 

0364 EC 

0365 3C 01 

0367 75 OA 

0369 BO 00 
036B EE 
036C EB 00 
036E EC 
036F 3C 00 
0371 74 03 

0373 

0373 E9 0600 R 


0376 

0376 FE 06 1002 R 
037A BA 0361 
037D 03 D3 

037F BO AA 


MOV DX, STATUS_REG 

ADD DX, BX 

I N AL, DX 

CMP AL,20H 

JNZ HIFT_FAIL1 

;--GET FIRST DATA BYTE-- 

I NC COUNT 

MOV DX,0ATA_REG 

ADD DX,BX 

I N AL, DX 

CMP AL,0AAH 

JNZ HIFT_FAIL1 

TEST DRF Sc DRE AGAIN 

MOV DX, STATUS_REG 

ADO DX. BX 

IN AL,DX 

CMP AL,30H 

JNZ HIFT_FAIL1 

;--GET 2N0 DATA BYTE— 

MOV DX, DATA.REG 

ADD 0X,BX 

IN AL,0X 

CMP AL,055H 

JNZ HIFT_FAIL1 

;— TEST DRF & DRE FOR THE 

MOV OX, STATUS_REG 

ADD DX, BX 

IN AL,DX 

CMP AL, 10H 

JNZ HIFT_FAIL1 

;— TEST REMAINING DATA— 

MOV DX,DATA_REG 

ADO DX,BX 

MOV AL.OFFH 

OUT DX,AL 

JMP SHORT $ +2 

IN AL.DX 

CMP AL.OFFH 

JNZ HIFT_FAIL1 

MOV AL.OIH 

OUT DX.AL 

JMP SHORT $ + 2 

IN AL.DX 

CMP AL.OIH 

JNZ HIFT_FAIL1 

MOV AL, OOH 

OUT DX.AL 

JMP SHORT $ + 2 

I N AL, OX 

CMP AL.OOH 

JZ RR4 

HIFT_FAIL1: 

JMP HIFT_FAILED 


GET SR 

DRF =1 DRE = 0 
JMP ERROR 


< 82 ) 


FIRST DATA BYTE 
JMP DATA NON COMPARE 


GET SR 

DRF =1 DRE = 1 
JMP NON COMPARE 


;GET DATA 

•JMP DATA NON COMPARE 
LAST TIME- 


GET THE STATUS 
DRF =0 DRE = 1 
JMP NON COMPARE 


FF 


TEST BYTE 

WRITE FIRST BYTE 01 
DELAY 

GET THE DATA 

JMP DATA NO COMPARE 
TEST BYTE 

WRITE FIRST BYTE 00 
DELAY 

GET THE DATA 

JMP DATA NO COMPARE 

END OF PROC 


; TEST PARAMETR REG- 


I NC COUNT 

MOV DX, PARAMETER_REG 

ADD DX. BX 

MOV AL, OAAH 


( 83 ) 

ADD OFFSET FOR I/O ADDRESS 


Adapter BIOS D-7 



883 

884 

885 

886 

887 

888 

889 

890 

891 

892 

893 

894 

895 

896 

897 

898 

899 

900 

901 

902 

903 

904 

905 

906 

907 

908 

909 

910 


914 

915 

916 

917 

918 

919 

920 


924 

925 

926 

927 

928 

929 

930 


934 

935 

936 

937 

938 

939 

940 


944 

945 

946 


954 

955 

956 

957 

958 

959 

960 


964 

965 

966 

967 

968 

969 

970 

971 

972 

973 

974 

975 

976 

977 

978 

979 

980 


987 

988 

989 


994 

995 

996 

997 

998 

999 

1000 
1001 
1002 

1003 

1004 

1005 

1006 

1007 

1008 


0381 EE 

0382 BO 55 
0384 EB 00 

0386 EE 

0387 BO FF 

0389 EB 00 
038B EE 
038C BO 01 
038E EB 00 

0390 EE 

0391 BO 00 
0393 EB 00 

0395 EE 

0396 EB 00 

0398 EE 

0399 EB 00 
039B EE 


039C EB 00 
039E EC 
039F 3C AA 
03A1 75 20 

03A3 EB 00 
03A5 EC 
03A6 3C 55 
03A8 75 26 

03AA EB 00 
03 AC EC 
03AD 3C FF 
03AF 75 IF 
03B1 EB 00 
03B3 EC 
03B4 3C 01 
03B6 75 18 

0388 EB 00 
03BA EC 
03BB 3C 00 
03BD 75 11 
03BF EB 00 
03C1 EC 
03C2 3C 00 
03C4 75 OA 

03C6 EB 00 
03C8 EC 
03C9 3C 00 
03CB 75 03 
03CD EB 04 90 
0300 

0300 E9 0600 R 


0303 

0303 FE 06 1002 R 
0307 BA 0363 
03DA 03 03 
03DC BO AA 
030E E8 0955 R 
03E1 E8 0796 R 
03E4 75 40 

03E6 BO 52 
03E8 E8 0955 R 
03EB E8 0796 R 
03EE 75 43 

03F0 BO FB 
03F2 E8 0955 R 
03 F5 E8 0796 R 
03F8 75 39 

03FA BO 01 
03FC E8 0955 R 
03FF E8 0796 R 
0402 75 2F 

0404 BO 00 
0406 E8 0955 R 
0409 E8 0796 R 
040C 75 25 


040E FE 06 1002 R 
0412 BA 0360 
0415 03 03 

0417 BO 02 

0419 E8 0955 R 

041C E8 0796 R 
041 F 24 07 
0421 3C 02 
0423 75 OE 

0425 BO 05 
0427 E8 0955 R 
042A E8 0796 R 

0420 24 07 

042F 3C 05 
0431 74 03 


0433 

0433 E9 0600 R 


0436 

0436 

0436 FE 06 1002 R 
043A E8 08F5 R 
0430 BA 0360 
0440 03 03 

0442 

0442 80 3E 100F R 

0447 75 08 


OUT DX,AL 

MOV AL,055H 

JMP SHORT $ +2 

OUT OX,AL 

MOV AL.OFFH 

JMP SHORT $ +2 

OUT OX,AL 

MOV AL.OIH 

JMP SHORT $ + 2 

OUT OX,AL 

MOV AL,00 

JMP SHORT $ + 2 

OUT DX,AL 

JMP SHORT $ + 2 

OUT DX,AL 

JMP SHORT $ + 2 

OUT DX,AL 


1 AA 

2 55 

3 FF 

4 01 

5 00 

6 00 

7 00 


; --VERIFY THE DATA- 


JMP SHORT $ + 2 

I N AL, DX 

CMP AL,OAAH 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

IN AL,DX 

CMP AL,055H 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

IN AL.DX 

CMP AL.OFFH 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

I N AL, DX 

CMP AL.OIH 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

IN AL.DX 

CMP AL,OOH 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

IN AL,DX 

CMP AL,OOH 

JNZ HIFT_FAIL2 

JMP SHORT $ + 2 

IN AL, DX 

CMP AL,OOH 

JNZ HIFT_FAIL2 

JMP RR6 

HIFT_FAIL2: 

JMP HIFT_FAILED 


2 55 

3 FF 


6 00 

7 00 

END OF PROC 


;---TEST THE HOST INTERFACE REG--- 


INC COUNT 

MOV DX,HOST_INTR_REG 

ADD DX,BX 

MOV AL,0AAH 

CALL WRT_REG 

CALL READ_REG 

JNZ HIFT_FAIL3 


( 84 : 

AA H 


MOV 

CALL 

CALL 

JNZ 


AL,052H 

WRT_REG 

READ_REG 

HIFT_FAIL3 


52H 


MOV 

CALL 

CALL 

JNZ 


AL,OFBH 

WRT_REG 

READ_REG 

HIFT_FAIL3 


FBH 


MOV AL,01H ; 01H 

CALL WRT_REG ; 

CALL READ_REG ; 

JNZ HIFT_FAIL3 ; 


MOV AL,00H 

CALL WRT_REG 

CALL READ_REG 

JNZ HIFT_FAIL3 


OOH 


; TEST THE STATUS REGISTER- 
ING COUNT 

MOV DX, STATUS_REG 

ADD DX, BX 

MOV AL,02H 

CALL WRT_REG 

CALL READ_REG 

AND AL,07H 

CMP AL,02H 

JNZ HIFT_FAIL3 

MOV AL,05H 

CALL WRT_REG 

CALL READ_REG 

AND AL,07H 

CMP AL,05H 

JZ I TO 

;;;LEAVE SR = 05-TELLS LANA THAT HOS’ 


( 85 ) 


GO WRITE THE STATUS REG 02 
READ IT 

REMOVE UNWANTED BITS 


;G0 WRITE THE STATUS REG 05 
;READ IT 

; REMOVE UNWANTED BITS 
; status ok 
ATTACHED; ; ; ; 


HI FT_FAIL3: 

JMP HIFT_FAILED 


; HOST INTERFACE INTERRUPT TESTS 

;WAIT FOR THE LANA TO SET THE CCO BIT IN STATUS REGISTER 


INTERRUPT_TESTS: 

ITO: 

INC COUNT 

CALL START_TIMER 
MOV DX, STATUS_REG 

ADD DX,BX 


; ( 86 ) 

;ADD OFFSET FOR I/O ADDRESS 


CMP T_0_FLAG,80H ; 

JNZ IT_1A . ;JMP NO TIME OUT 


D-8 Adapter BIOS 



1009 

1010 0449 

1011 044E 

1012 

1013 0451 

1014 0451 

1015 0452 

1016 0454 

1017 

1018 

1019 

1020 0456 

1021 
1022 

1023 

1024 0459 

1025 045C 

1026 045E 

1027 0460 

1028 

1029 

1030 0461 

1031 

1032 

1033 

1034 

1035 0464 

1036 0467 

1037 0468 

1038 0469 

1039 046A 

1040 046B 

1041 

1042 

1043 

1044 0470 

1045 0473 

1046 0475 

1047 0477 

1048 0478 

1049 

1050 

1051 

1052 

1053 

1054 047C 

1055 

1056 047C 

1057 047F 

1058 0481 

1059 0484 

1060 0486 

1061 0488 

1062 

1063 

1064 0488 

1065 048B 

1066 048D 

1067 0490 

1068 0493 

1069 

1070 0496 

1071 0496 

1072 0499 

1073 

1074 049C 

1075 

1076 

1077 

1078 

1079 

1080 

1081 049C 

1082 04A0 

1083 

1084 04A5 

1085 04A7 

1086 04AA 

1087 04AC 

1088 

1089 

1090 

1091 04AD 

1092 

1093 04AD 

1094 04B0 

1095 04B2 

1096 04B5 

1097 04B7 

1098 

1099 04B9 

1100 
1101 
1102 

1103 04B9 

1104 04BD 

1105 04C0 

1106 04C2 

1107 

1108 

1109 

1110 04C3 

1111 04C6 

1112 04C8 

1113 04CA 

1114 


1117 04CB 

1118 04C0 

1119 04D0 

1120 04D2 

1121 
1122 

1123 

1124 0403 

1125 

1126 0408 

1127 04DB 

1128 0400 

1129 040F 

1130 

1131 

1132 

1133 04E0 

1134 04E2 


C6 06 1015 R 80 
E9 04ED R 


EC 

A8 02 
74 EC 


E8 08B2 R 


BA 0363 
03 03 
BO 01 
EE 


E8 018C R 


E8 02A0 R 

90 

90 

90 

90 

C6 06 1000 R 00 


BA 0360 
03 03 
BO 01 
EE 

FE 06 1002 R 


E8 093A R 
74 FB 
80 FC 80 
74 02 
EB 65 


83 FB 00 
74 09 
AO 1011 R 
A2 1013 R 
EB 07 90 


AO 1011 R 
A2 1012 R 


FE 06 1002 R 
C6 06 1000 R 00 

BO 10 
BA 0363 
03 D3 
EE 


E8 093A R 
74 FB 
80 FC 80 
74 02 
EB 34 


FE 06 1002 R 
BA 0362 
03 D3 
EC 


BA 0363 
03 D3 
BO 00 
EE 


BO 02 
BA 0360 
03 D3 
EE 


C6 06 1000 R 00 

BA 0363 
03 D3 
BO 08 
EE 


BO 18 
EE 


;TIME OUT HAS ELASPED SET FAIL TO SYNC FLAG 

MOV NO_SYNC,80H ;SET FLAG 

JMP HIFT_FAIL4 ;JMP GROSS TIME OUT 


I N AL, DX 

TEST AL.02H 

JZ IT_1 


GET THE STATUS REGISTER 
LANA SETS CCO = 1 TO SYNC IN 
JMP IF CCO NOT SET YET 


; SET VECTORS FOR 2*3- 


CALL SET_VECT_2_3 


;--SET THE Gl ENABLE FOR THE HOST-— 


MOV DX, HOST_ I NTR_REG 

ADD DX,BX ;ADD 

MOV AL.01 

OUT DX,AL 

; 10-23 

CALL CLR_LANA_INTS 

— -ENABLE I NT 2 OR 3 

; 10-16 

CALL ENABLE_INTS 

NOP 

NOP 

NOP 

NOP 

MOV INT_OCCUR?,OOH 


OFFSET 

;G0 INTERRUPT ENABLE FOR HOST 
; ENABLE THE HOST I NT 

; CLEAR ANY I NTS THAT MAY BE SET 

;LANAO=INT 2,3 LANA1=INT ? 

•CLEAR THE FLAG 


■SET GO BIT TO LANA 


MOV 

ADD 

MOV 

OUT 

INC 


DX, STATUS_REG 

DX,BX 

AL,01 


ADD OFFSET 
GO BIT INTERRUPT 
THIS SHOULD CAUSE A LANA I NT 
( 87 ) 


.---NOW TEST THE CLEAR GO INTERRUPT TO THE HOST-- 
; WAIT FOR THE LANA TO CLEAR GO AND CAUSE A HOST I NT 


CALL TIME_OUT_OR_INT? 

JZ I T_7 

CMP AH,80H 

JZ I T_8 

JMP SHORT HIFT_FAIL4 

IT_8; 

SAVE I NT INFO 


SEE IF GROSS TIME OUT OR I NT OCCURRED 
JMP NO T_0 OR I NT 
WAS IT A I NT? 

JMP I NT OCCURRED 


CMP BX,0 

JZ IT8A 

MOV AL,TEMP_INT 
MOV LANA_1_INT,AL 

JMP IT8B 


WORKING ON LANA 0? 

JMP YES 

SAVE THE I NT LEVEL LANA 1 


MOV AL,TEMP_INT ; 

MOV LANA_0_INT,AL ; SAVE THE I NT LEVEL LANA 0 


IT8B: 


;DATA REGISTER INTERRUPT 

;TEST INTERRUPTS TO HOST AND LANA 
;DATA XFER LANA > HOST 

INC COUNT 

MOV INT_OCCUR?,OOH 

MOV AL,10H 

MOV DX,HOST_INTR_REG 

ADD DX,BX 

OUT OX,AL 

;WAIT FOR THE I NT FROM LANA 


CALL TIME_OUT_OR_INT? 

JZ I T_9 

CMP AH,80H 

JZ IT_10 

JMP SHORT HIFT_FAIL4 


:( 88 ) 

; CLEAR THE I NT FLAG 

;DATA XFER INTERRUPT ENABLE DTI 

•ADD OFFSET 

; ENABLE HOST FOR DTI I NT FROM LANA 


SEE IF GROSS TIME OUT OR I NT OCCURRED 
JMP NO T_0 OR I NT 
WAS IT A I NT? 

JMP I NT OCCURRED 


READ BYTE FROM DATA REG (ORE) CAUSE I NT TO LANA 

INC COUNT ;( 89 ) 

MOV DX, DATA_REG ; 

ADD DX,BX ;ADD OFFSET 

IN AL,DX ;READ DATA REG/ CAUSE DRE /I NT LANA 

--CLEAR THE DTI BIT IN HIR 

MOV DX,HOST_INTR_REG 

ADD DX,BX 

MOV AL,OOH 

OUT DX,AL 

SYNC THE LANA WITH CCO BIT— 

MOV AL,02H 

MOV DX, STATUS_REG 

ADD DX, BX 

OUT DX,AL 

; DATA XFER HOST >LANA 

MOV INT_OCCUR?,OOH 

MOV DX,HOST_INTR_REG 

ADD DX, BX 

MOV AL,08H 

OUT DX,AL 

NOW ENABLE THE DTI INTERRUPT— 

MOV AL, 18H ;DD=1 AND DTI = 1 

OUT DX,AL ; 


;SET CCO = 1 

; OFFSET 
;SYNC IT 

; CLEAR THE FU\G 

Jaod offset 

;0D=1=H0ST TO LANA 


ADD OFFSET 
CLEAR THE DTI BIT 
DO IT 
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1135 

1136 

1137 

1138 


1145 

1146 

1147 

1148 


1159 

1160 
1161 
1162 

1163 

1164 

1165 

1166 

1167 

1168 
1169 


1176 

1177 

1178 

1179 


04E3 

04E3 E8 093A R 
04E6 74 FB 

04E8 80 FC 80 

04EB 74 03 
04ED 

04 ED E9 0600 R 
04F0 


04 FO BO 08 
04F2 BA 0363 
04F5 03 03 

04F7 EE 


04F8 BA 0362 
04FB 03 03 
04FD EE 


1189 

1190 

1191 

1192 


1196 

1197 

1198 


1202 

1203 

1204 

1205 

1206 

1207 

1208 

1209 

1210 
1211 
1212 

1213 

1214 

1215 

1216 

1217 

1218 

1219 

1220 
1221 
1222 

1223 

1224 

1225 

1226 

1227 

1228 

1229 

1230 

1231 

1232 

1233 

1234 

1235 

1236 

1237 

1238 

1239 

1240 

1241 

1242 

1243 

1244 

1245 

1246 

1247 

1248 

1249 

1250 

1251 

1252 

1253 

1254 

1255 

1256 

1257 

1258 

1259 

1260 


04FE FE 06 1002 R 


0502 BO 07 
0504 E6 OA 

0506 C6 06 1000 R 00 


050B C6 06 101 E R 55 
0510 C6 06 101F R AA 

0515 33 CO 

0517 BF 101E R 
051A E8 0270 R 


0510 E8 08CD R 
0520 C6 06 1000 R 00 


0525 BO 4B 
0527 E6 OB 


0529 BA 0363 
052C 03 03 

052E BO 68 


0530 EE 


0531 BO 03 
0533 E6 OA 


0535 

0535 E8 093A R 
0538 74 FB 

053A 80 FC 80 

0530 74 02 

053F EB 50 
0541 


0541 FE 06 1002 R 
0545 BO 08 
0547 BA 0363 
054A 03 03 

054C EE 


0540 BO 00 
054F EE 


SHOULD GET A ORE INTERRUPT-- 

IT11: 

CALL TIME 0UT_0R_INT? 

J2 IT1l“ 

CMP AH,80H 

JZ IT12 

HI FT FAIL4: 

JMP HIFT_FAILED 

IT12: 

CLEAR DTI — 

MOV AL,08H 

MOV OX, HOST I NTR_REG 

ADD OX, BX 

OUT DX,AL 


;SEE IF GROSS TIME OUT OR I NT OCCURRED 
;JMP NO T_0 OR I NT 
;WAS IT A I NT? 

;JMP I NT OCCURRED 

;END OF PROC 


; CLEAR THE DTI LEAVE DO = 1 


I CLEAR THE DTI IN HIR 


WRITE TO DATA REG, CAUSE LANA I NT 

MOV OX, DATA REG ; 

ADD DX,BX ;ADD OFFSET 

OUT DX.AL ; 


;4.3.6.4 DATA REGISTER DMA 


DMA ADDRESSING 
CHAN 0 CHAN 1 

00 R/W ADDRESS 02 R/W ADDRESS 04 

01 R/W WD/CNT 03 R/W WD/CNT 05 


CHAN 2 CHAN 3 

R/W ADDRESS 06 R/W ADDDRE 
R/W WD/CNT 07 R/W WD/CNT 


08 READ STATUS REG 


WRITE COMMAND REG 
09 WRITE REQUEST REG 

OA WRITE SINGLE MASK REG BIT 

OB WRITE MODE REG 

OC CLEAR BYTE POINTER F/F 

OD READ TEMPORARY REG 
MASTER CLEAR 
OE ILLEGAL 

OF WRITE ALL MASK REG BITS 



;DMA XFER HOST — -> LANA ( 2 BYTES AA/55 ) 

;SET UP THE DMA 

INC COUNT ;( 8A ) 

;MASK OF DMA CHAN 3 

MOV AL,DMA_MASK + DMA_CHAN3 ;MASK OFF DMA3 REQUESTS 

OUT DMA_SINGLE_MASK,AL ; 

MOV INT_OCCUR?,OOH ; CLEAR THE I NT FLAG 


; SUPPLY THE 20 BIT DMA ADDRESS 


MOV DMA_DATA, 055H 

MOV DMA_DATA + 1,0AAH 

XOR AX, AX 

MOV Dl, OFFSET DMA_DATA 

CALL DMA_ADDRESS 


;SET THE WORD COUNT 
CALL SET_WO_CNT 

MOV INT_OCCUR?,OOH 

;SET THE MODE FOR READ 

MOV AL,4BH 

OUT DMA + OBH,AL 

;SET HIR FOR DMA XFER FROM HOST 

MOV DX,HOST_INTR_REG 

ADD DX,BX 

MOV AL,68H 


OUT DX.AL 

; REMOVE THE MASK FROM CHAN 3 


•SUPPLY DATA FOR DMA XFER 
;FOR CONVERSION ROUTINE 
•SUPPLY THE DMA WITH ADDRESS 


;G0 SET WORD COUNT FOR XFER OF 2 
; CLEAR THE I NT FLAG 


; SINGLE MODE, ADD INC, AUTO DIS,READ,03 
; WRITE THE MODE REGISTER 

TO LANA 


ADD OFFSET 
DD=1=H0ST TO LANA 
DTD=1=DMA 

TCI = 1 = TERM INAL COUNT I NT TO HOST 
SET UP HIR 


MOV AL,03 

OUT DMA ■♦• OAH.AL 


; CLEAR MASK BIT FOR CHAN 3 
;WRT SINGLE MASK REG 
;2 DAM XFERS SHOULD OCCUR 


; FI ELD THE I NT FROM TERMINAL COUNT 


DMA1 : 


CALL T I ME_OUT_OR I NT? 

JZ DMA1 

CMP AH,80H 

JZ DMA2 

JMP SHORT HI FT FAILS 

DMA2: 

; --CLEAR THE DTD BIT— 

I NC COUNT 

MOV AL,08H 

MOV DX.HOST INTR REG 

ADD DX,BX ~ 

OUT DX.AL 

{—CLEAR THE DD BIT -- 

MOV AL.OOH 

OUT DX.AL 

{—DMA XFER LANA — >HOST 


{SEE IF GROSS TIME OUT OR I NT OCCURRED 
{JMP NO T_0 OR I NT 
{WAS IT A I NT? 

{JMP I NT OCCURRED 


( SB ) 

CLEAR THE DTD BIT LEAVE DD ON FOR NOW 
ADD OFFSET 


•DTD AND DO BOTH CLEAR NOW 


{MASK OF DMA CHAN 3 
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1262 

1263 

1264 

1265 

1266 

1267 

1268 

1269 

1270 

1271 

1272 

1273 

1274 

1275 

1276 

1277 

1278 

1279 

1280 
1281 
1282 

1283 

1284 

1285 

1286 

1287 

1288 

1289 

1290 

1291 

1292 

1293 

1294 

1295 

1296 

1297 

1298 

1299 

1300 

1301 


1332 

1333 

1334 


1353 

1354 

1355 

1356 


1364 

1365 

1366 

1367 

1368 

1369 

1370 

1371 

1372 

1373 

1374 

1375 

1376 

1377 

1378 

1379 

1380 

1381 

1382 

1383 

1384 

1385 

1386 


0550 BO 07 
0552 E6 OA 

0554 C6 06 1000 R 00 


0559 BF 1003 R 
055C 33 CO 

055E E8 027D R 


0561 E8 08CD R 


0564 BO 47 
0566 E6 OB 


0568 BA 0363 
056B 03 03 

0560 BO 60 


056F EE 


0570 BO 03 
0572 E6 OA 


0574 

0574 E8 093A R 
0577 74 FB 

0579 80 FC 80 

057C 74 02 

057E EB IE 

0580 


0580 FE 06 1002 R 
0584 BO 00 
0586 BA 0363 
0589 03 D3 

0583 EE 


058C 33 CO 

058E 8E 08 
0590 AO 1003 R 
0593 3C 55 
0595 75 07 

0597 AO 1004 R 
059A 3C AA 
059C 74 03 

059 E 

059E EB 60 90 
05A1 

05A1 BA 0362 
05A4 03 03 

05A6 EC 


05A7 


05A7 FE 06 1002 R 

05AB C6 06 1000 R 00 

05B0 BA 0363 

05B3 03 03 

05B5 BO 82 


05B7 EE 


05B8 

05B8 FE 06 1002 R 
05BC E8 093A R 
05BF 74 F7 
05C1 80 FC 80 

05C4 74 02 

05C6 EB 45 


05C8 

05C8 EC 
05C9 A8 80 
05CB 75 03 
05C0 EB 3E 90 


0500 


0500 80 3E 100F R 80 

0505 75 03 

0507 EB 34 90 

050A 

050A BA 0360 
0500 03 03 

05DF EC 
05E0 A8 02 
05E2 75 EC 


MOV AL,DMA_MASK + 0MA_CHAN3 ;MASK OFF DMA3 REQUESTS 

OUT DMA_SINGLE_MASK,AL ; 

MOV INT_OCCUR?,OOH ; CLEAR THE I NT FLAG 


;SET 

MOV 

XOR 

CALL 

;SET 

CALL 

;SET 

MOV 

OUT 


;SET 


OMA ADORESS 

01, OFFSET OATA_XFER 
AX, AX 

OMA_AOORESS 
THE WORO COUNT 
SET_WO_CNT 
THE MODE FOR WRITE 
AL,47H 

DMA + OBH,AL 
HIR FOR DMA XFER LANA TO HOST 


PUT THE DMA DATA HERE 
SEGMENT = 0 

CONVERT SEGMENT & OFFSET TO 20 BIT ADD 


;SET FOR XFER 2 BYTES 


MOV DX,HOST_INTR_REG ; 

ADD DX,BX ;AOD OFFSET 

MOV AL,60H ;DD=0=LANA TO HOST 

; DTD=1=DMA 

;TC1 = 1 = TERMtNAL COUNT I NT TO HOST 
OUT DX,AL ;SET UP HIR 


; REMOVE THE MASK FROM CHAN 3 


MOV AL,03 

OUT DMA + OAH,AL 


; CLEAR MASK BIT FOR CHAN 3 
;WRT SINGLE MASK REG 


; FIELD TERMINAL COUNT INTERRUPT FROM OMA XFER 


DMA3: 


CALL TIME_OUT_OR_INT? 

JZ DMA3 

CMP AH,80H 

JZ DMA4 

JMP SHORT HIFT_FAIL5 


;SEE IF GROSS TIME OUT OR I NT OCCURRED 
;JMP NO T_0 OR I NT 
:WAS IT A I NT? 

:JMP I NT OCCURRED 


DMA4 ; 

;--CLEAR THE DTD AND TCI BIT-- 


INC COUNT 

MOV AL,OOH 

MOV DX,HOST_INTR_REG 

ADD DX, BX 

OUT DX,AL 

; --CHECK THE DATA FROM THE 

XOR AX, AX 

MOV DS,AX 

MOV AL,DATA_XFER 

CMP AL,055H 

JNZ HIFT_FAIL5 

MOV AL,DATA_XFER +1 

CMP AL,OAAH 

JZ DMA5 

HIFT_FAIL5: 

JMP HIFT_FAILED 


MOV DX,DATA_REG 

ADD DX,BX 

IN AL,DX 


;( 8C ) 

; CLEAR THE HIR 

•OFFSET 

DMA XFER 

•SET UP DS 

;GET THE FIRST DATA BYTE 

•JMP DATA DOESN'T COMP 
;GET SECOND BYTE 

;JMP DATA COMPARE 

; CLEAR THE DATA REG 


;4.3.6.5. INTERFACE CONTROL 


;GET READY TO I NT ON THE HOST CONTROL REQ BEING ENABLED 


MOV 

ADD 

MOV 


DX, HOST_ 

DX,BX 

AL,82H 


;ADD OFFSET 

;HCI=1=INT ON HOST CONTROL 
;HCR=1=H0ST CONTROL REQUEST 

;SET UP THE HOST 


; FIELD THE I NT 


CALL 

JZ 

CMP 

JZ 

JMP 


AH,80H 
IC5A 
SHORT H 


( 8E ) 

SEE IF GROSS TIME OUT OR I NT OCCURRED 
JMP NO T_0 OR I NT 
WAS IT A I NT? 

JMP I NT OCCURRED 


--CHECK THE HC BIT IN STATUS REG-- 


TEST AL,80H 

JNZ IC6 

JMP HIFT_FAILED 


GET STATUS REG 
HC SHOULD BE ACTIVE 
JMP HC ACTIVE 
HC NOT ACTIVE 


--WAIT FOR LANA TO SET CCO BIT = 0 


CMP 

JNZ 

JMP 


T_0_FLAG,80H 

IC6A 

HIFT_FAILED 


DX,STATUS_REG 

DX,BX 

AL,DX 

AL,02H 


GET STATUS REG 
IS CCO = 0 
JMP IF CCO = 1 


Adapter BIOS D-11 



1402 

1403 

1404 

1405 

1406 

1407 

1408 

1409 

1410 


05E4 BA 0363 
05E7 03 03 

05 E9 BO 00 
05EB EE 


05EC 90 
05ED BO 02 
05EF EE 
05F0 90 


05F1 FE 06 1002 R 
05F5 BA 0360 
05F8 03 03 

05FA EC 
05FB A8 80 
05FD 75 OE 


05FF FE 06 1002 R 
0603 BO 00 
0605 BA 0363 
0608 03 03 

060A EE 
060B F8 
060C C3 

0600 


1419 

1420 

1421 

1422 

1423 

1424 

1425 

1426 

1427 

1428 

1429 

1430 


1434 

1435 

1436 

1437 

1438 

1439 

1440 

1441 

1442 

1443 

1444 

1445 

1446 

1447 

1448 

1449 

1450 

1451 

1452 

1453 

1454 

1455 

1456 

1457 

1458 

1459 

1460 

1461 

1462 

1463 

1464 

1465 

1466 

1467 

1468 

1469 

1470 

1471 

1472 

1473 

1474 

1475 

1476 

1477 

1478 

1479 

1480 

1481 

1482 

1483 

1484 

1485 

1486 

1487 

1488 

1489 

1490 

1491 

1492 

1493 

1494 

1495 

1496 


1505 

1506 

1507 

1508 

1509 

1510 


0600 BO 00 
060F BA 0363 
0612 03 03 

0614 EE 

0615 F9 

0616 C3 

0617 

0617 


0617 E8 08F5 R 
061A C6 06 1006 R 80 


061 F 

061 F BA 0360 
0622 03 03 

0624 EC 

0625 A8 01 

0627 75 OA 

0629 80 3E 100F R 80 

062E 75 EF 

0630 EB 58 90 

0633 


0633 BA 0361 
0636 03 03 

0638 EC 

0639 3C 45 

063B 74 11 


0630 83 FB 00 

0640 75 06 

0642 BE 0205 R 
0645 EB 45 90 

0648 

0648 BE 0265 R 
064B EB 3F 90 

064E 

064E EC 
064F 3C 41 
0651 75 11 


0653 83 FB 00 

0656 75 06 

0658 BE 0211 R 
065B EB 2F 90 
065E 

065E BE 0271 R 
0661 EB 29 90 

0664 

0664 3C 42 
0666 75 11 


0668 83 FB 00 

066B 75 06 

0660 BE 0217 R 
0670 EB 1A 90 
0673 

0673 BE 0277 R 
0676 EB 14 90 

0679 

0679 83 FB 00 

067C 75 06 

067E BE 0205 R 
0681 EB 09 90 
0684 

0684 BE 0265 R 
0687 EB 03 90 

068A 

068A F8 


.•GENERATE A HC CLEAR I NT TO LANA 


MOV 

ADD 

MOV 

OUT 


DX. HOST_INTR_REG 

DX.BX 

AL.OO 

DX.AL 


ADD OFFSET 

TURN OFF THE HOST CONTROL REQUEST 
INTERRUPT THE LANA 


INSURE HCR IS NOT ACCEPTED WHEN LANA HAS HCE = 0 

NOP 

MOV AL, 02H 


.•—VERIFY NO HC SET— 

I NC COUNT 

MOV DX. STATUS_REG 

ADD DX.BX 

IN AL.DX 

TEST AL.80H 

JNZ HIFT_FAILED 

;— NOW CLEAR THE HIR— 

INC COUNT 

MOV AL.OO 

MOV DX.HOST_INTR_REG 

ADD DX. BX 

OUT DX.AL 

CLC 

RET 


( 8F ) 


GET THE STATUS REGISTER 

IS THE HC SET 

JMP FAILURE HC I S ON 


( 90 ) 


ADD OFFSET 

CLEAR THE HIR REG 

FLAG SET FOR GOOD RETURN 


IIFT_FAILED: 

;--Cl 

MOV 

MOV 

ADD 

OUT 

STC 

RET 

IIFT_TEST 


AL.OO 

DX.HOST_INTR_REG 

DX.BX 

DX.AL 


IS OFF SO LANA CAN GET INTERFACE 


ADD OFFSET 

CLEAR THE HIR REG 

FLAG SET FOR ERROR RETURN 


HOT_RF? PROC NEAR ; 

;LANA RETURNED A 8E ERROR CODE. INDICATING A POTENTIAL HOT CARRIER 
;LOOK FOR THE GO BIT AND CMD 45. LANA MAY TAKE UP TO 45 SECONDS TO 
; RETURN A HOT CARRIER. IF AFTER 45 SECONDS NO CMD 45 THEN NORMAL EXIT. 
;IF CMD 45 DETERMINE IF HOT CARRIER ON THIS CARD OR 
;ON THE NET. DISPLAY THE APPROIATE MESSAGE. 


CMP 

JNZ 

JMP 


DX. STATUS_REG 

DX.BX 

AL.DX 

AL.01 

HR2 

T_0_FLAG.80H 

HR1 

HC8 


INITIALIZE THE TIME 
SET FLAG FOR 'TICKS PROC' 
INDICATES THAT HOT CARRIER TEST 
PROCESS 


OFFSET 

GET STATUS REG 
GO BIT ON? 

JMP YES 

HAS 45 SEC'S ELASPED? 

JMP NO-CONTINUE TO LOOK 
JMP TIME EXPIERED-EXIT NORMAL 


;GO BIT ON - CMD 45 ? 

MOV DX. PARAMETER_REG 
ADD DX. BX 

I N AL, DX 

CMP AL,45H 

JZ HC5 

;NOT CMD 45 

; NEVER SHOULD GET HERE 


CMP 

JNZ 

MOV 

JMP 


BX,0 

HR3 

SI. OFFSET M13 
HC9 


’ DIGITAL FAILURE' 


AL.DX 
AL.41H 
HC6 

; CONTINUOUS CARRIER 8c ITS NOT ME 


CMP 

JNZ 

MOV 

JMP 


BX.O 
HC5A 
SI, OFFSET M50 
HC9 


; CONTINUOUS CARRIER AND ITS ME 


CMP 

JNZ 

MOV 

JMP 


BX.O 

HC6A 

SI, OFFSET M51 
HC9 


; CONTINUOUS CARRIER ME? 
( 3X42 ) 

; FIRST CARD? 

•3042 

;3142 


;DMA FAILURE ? 


CMP 

JNZ 

MOV 

JMP 


BX.O 
HC7A 
SI .OFFSET 
HC9 


; FIRST CARD 
•3013 


D-12 Adapter BIOS 



1513 068B C3 

1514 068C 

1515 

1516 068C E8 01A4 R 

1517 068F C6 06 1005 R 80 

1518 0694 OE 

1519 0695 50 

1520 0696 F9 

1521 0697 C3 

1522 

1523 0698 

1524 

1525 0698 

1526 0698 80 3E 1014 R 00 

1527 0690 74 OB 

1528 069F 

1529 069F AO 1013 R 

1530 06A2 38 06 1012 R 

1531 06A6 75 02 

1532 06A8 F9 

1533 06A9 C3 

1534 06AA 

1535 06AA F8 

1536 06AB C3 

1537 

1538 06AC 

1539 

1540 06AC 

1541 06AC 52 

1542 06AD 53 

1543 06AE IE 

1544 06AF 50 

1545 06B0 33 CO 

1546 06B2 8E 08 

1547 06B4 C6 06 1000 R 80 

1548 06B9 C6 06 1011 R 04 

1549 

1550 06BE BA 0360 

1551 06C1 03 03 

1552 06C3 EC 

1553 06C4 EB 00 

1554 06C6 OC 80 

1555 06C8 EE 

1556 06C9 BO 20 

1557 06CB E6 20 

1558 06CD 58 

1559 06CE IF 

1560 06CF 5B 

1561 0600 5A 

1562 0601 CF 

1563 0602 

1564 

1565 0602 

1566 0602 52 

1567 0603 53 

1568 0604 IE 

1569 0605 50 

1570 0606 33 CO 

1571 0608 8E 08 

1572 06DA C6 06 1000 R 80 

1573 060F C6 0^ 1011 R 08 

1574 

1575 06E4 BA 0360 

1576 06E7 03 03 

1577 06E9 EC 

1578 06EA EB 00 

1579 06EC OC 80 

1580 06EE EE 

1581 06EF BO 20 

1582 06F1 E6 20 

1583 06F3 58 

1584 06F4 IF 

1585 06F5 5B 

1586 06F6 5A 

1587 06F7 CF 

1588 06F8 

1589 

1590 06F8 

1591 

1592 06F8 B1 04 

1593 06FA B8 FFFF 

1594 06FD 50 

1595 06FE 58 

1596 06FF EC 

1597 0700 3A Cl 

1598 0702 75 02 

1599 0704 F8 

1600 0705 C3 

1601 0706 

1602 

1603 0706 F9 

1604 0707 C3 

1605 0708 

1606 

1607 0708 

1608 0708 E4 21 

1609 070A OC OC 

1610 070C E6 21 

1611 070E C3 

1612 070F 

1613 

1614 070F 

1615 

1616 070F 3C 8F 

1617 0711 75 OF 

1618 

1619 0713 

1620 

1621 0713 83 FB 00 

1622 0716 75 05 

1623 

1624 0718 BE 020B R 

1625 071B EB 66 

1626 

1627 0710 

1628 

1629 0710 BE 026B R 

1630 0720 EB 61 

1631 

1632 0722 

1633 

1634 

1635 0722 83 FB 00 

1636 0725 75 05 

1637 0727 BE 01B0 R 

1638 072A EB 03 



Adapter BIOS D-13 



1639 

072C 


P El: 



1640 

072C 

BE 0210 R 

MOV 

SI, OFFSET M21 

; POINT TO SECONDARY ERROR LIST 

1641 






1642 

072F 


P E2: 



1643 

072F 

3C 81 

CMP 

AL,81H 


1644 

0731 

74 50 

JZ 

P E3 

; PROCESSOR ERROR 

1645 

0733 

83 C6 06 

AOO 

SI, 6 

;3X01 

1646 

0736 

3C 82 

CMP 

AL,82H 


1647 

0738 

74 49 

JZ 

P E3 

;ROS FAILED 

1648 

073A 

83 C6 06 

ADD 

SI, 6 

; 3X02 

1649 

0730 

3C 83 

CMP 

AL,83H 


1650 

073F 

74 42 

JZ 

P E3 

; ID MODULE FAILED 

1651 

0741 

83 C6 06 

ADD 

SI ,6 

; 3X03 

1652 

0744 

3C 84 

CMP 

AL,84H 


1653 

0746 

74 3B 

JZ 

P E3 

;RAM FAILURE 

1654 

0748 

83 C6 06 

ADD 

SI ,6 

; 3X04 

1655 

0748 

3C 85 

CMP 

AL,85H 


1656 

0740 

74 34 

JZ 

P E3 

;HIC FAILURE 

1657 

074F 

83 C6 06 

ADD 

SI ,6 

; 3X05 

1658 

0752 

3C 86 

CMP 

AL,86h 


1659 

0754 

74 20 

JZ 

P E3 

;+ - 12V FAILURE 

1660 

0756 

83 C6 06 

ADD 

SI ,6 

; 3X06 

1661 

0759 

3C 87 

CMP 

AL,87h 


1662 

0758 

74 26 

JZ 

P E3 

; DIGITAL WRAP FAILURE 

1663 

0750 

83 C6 06 

ADD 

SI, 6 

;3X07 

1664 






1665 

0760 

3C 88 

CMP 

AL,88h 


1666 

0762 

74 IF 

JZ 

P E3 

;H0ST DETECTED HIC FAILURE 

1667 

0764 

83 C6 06 

ADD 

SI, 6 

;3X08 

1668 






1669 

0767 

3C 89 

CMP 

AL,89h 


1670 

0769 

74 18 

JZ 

P E3 

;SYNC FAIL & NO GO BIT 

1671 

0768 

83 C6 06 

ADD 

SI, 6 

;3X09 

1672 






1673 

076E 

3C 8A 

CMP 

AL,8Ah 


1674 

0770 

74 11 

JZ 

P E3 

;HIC TEST OK & NEVER GOT GO BIT 

1675 

0772 

83 C6 06 

ADD 

SI, 6 

;3X10 

1676 






1677 

0775 

3C 88 

CMP 

AL,8Bh 


1678 

0777 

74 OA 

JZ 

P E3 

;G0 BIT 8e NO CMD 41 

1679 

0779 

83 C6 06 

ADD 

SI, 6 

;3X11 

1680 






1681 

077C 

3C 8C 

CMP 

AL,8Ch 


1682 

077E 

74 03 

JZ 

P E3 

; FAILED PRESENCE TEST 3X12 

1683 






1684 

0780 

83 C6 06 

ADD 

SI ,6 

;FELL THRU SHOULD NOT GET HERE 3X13 

1685 






1686 






1687 

0783 


P E3: 



1688 

0783 

E8 01A4 R 

CALL 

DISPLAY 


1689 






1690 

0786 


PC 7: 



1691 

0786 

OE 

PUSH 

CS 


1692 

0787 

50 

POP 

BP 

; ERROR ID "FI" STOP 

1693 

0788 

C6 06 1005 R 80 

MOV 

FAIL FLAG,80H 

;SET THE FAILED FLAG 

1694 

0780 

AO 1002 R 

MOV 

AL, COUNT 

;GET ERROR LOG 

1695 

0790 

BA 0362 

MOV 

DX,DATA REG 


1696 

0793 

EE 

OUT 

DX,AL 


1697 

0794 

EE 

OUT 

DX,AL 

;2 BYTES TO DATA REGISTER 

1698 






1699 






1700 

0795 

C3 

RET 



1701 






1702 

0796 


PC_ERROR 

ENDP 








1704 

0796 


read' REG* " " 

PROC' ” " " " ' "near' 

' ; entered' wi th' base' I /o' add' 1 n' dx" " " ' 

1705 

0796 

8A EO 

MOV 

AH,AL 

;& DATA TO BE COMPARED IN AL 

1706 

0798 

EC 

IN 

AL,DX 

;GET the data 

1707 

0799 

3A EO 

CMP 

AH, AL 


1708 

0798 

C3 

RET 


•RETURN WITH FLAGS 

1709 

079C 


READ_REG 

ENDP 








1711 

079C 


REMOVE RESETO 

PROc' "near' """""" 

' ; remove' reset' FROm' LANa' 6' 

1712 

079C 

33 CO 

XOR 

AX, AX 

; REMOVE THE RESET BIT IN HIR/ AH=00 

1713 

079E 

BA 0363 

MOV 

DX,HOST INTR REG 


1714 

07A1 

EE 

OUT 

DX, AL 

•remove the reset from LANA 0 

1715 






1716 



;2ND 

RESET TO CARD 


1717 

07A2 

EB 00 

JMP 

SHORT $ + 2 


1718 






1719 

07A4 

BO 04 

MOV 

AL, RESET 


1720 

07A6 

EE 

OUT 

DX,AL 

■RESET LANA 0 2ND TIME 

1721 

07A7 

EB 00 

JMP 

SHORT $ + 2 


1722 






1723 

07A9 

32 CO 

XOR 

AL,AL 


1724 

07A8 

EE 

OUT 

DX,AL 

•REMOVE RESET 

1725 






1726 

07AC 

C3 

RET 



1727 

07A0 


REMOVE_RESETO 

ENDP 








1729 

07AD 


removeIreset'i 

'pROc' ' ' near' 

’ ' • remove’ the' reset' 'from' lanV ^ " " ’ ' " " 

1730 





;LANA ADD 368-36B 

1731 

07A0 

33 CO 

XOR 


; REMOVE THE RESET BIT IN HIR/ AH=00 

1732 

07AF 

BA 0363 

MOV 

DX,HOST INTR REG 


1733 

0782 

03 03 

ADD 

DX,BX 

•ADD OFFSET FOR I/O ADDRESS 

1734 

0784 

EE 

OUT 

DX,AL 

; REMOVE THE RESET FROM LANA 1 

1735 

0785 

EB 00 

JMP 

SHORT $ + 2 


1736 






1737 



;2ND 

RESET TO CARD 


1738 






1739 

0787 

BO 04 

MOV 

AL, RESET 


1740 

0789 

EE 

OUT 

DX,AL 

•RESET LANA 1 2ND TIME 

1741 

07BA 

EB 00 

JMP 

SHORT $ + 2 


1742 






1743 

07BC 

32 CO 

XOR 

AL,AL 


1744 

07BE 

EE 

OUT 

DX,AL 

•REMOVE RESET 

1745 






1746 

07BF 

C3 

RET 



1747 

07C0 


REM0VE_RESET1 

ENDP 








1749 

07CO 


restore' t'ick' 

VECTOR PROC NEAR 


1750 

07C0 

FA 

CLI 


•NO INTERRUPTS 

1751 

07C1 

A1 1009 R 

MOV 

AX, SAVE TICK INT 

;GIT THE ORIGINAL VECTOR INFO 

1752 

07C4 

A3 0070 R 

MOV 

TICK INT, AX 

; RESTORE 

1753 

07C7 

A1 100B R 

MOV 

AX, SAVE TICK INT +2 


1754 

07CA 

A3 0072 R 

MOV 

TICK. INT +2 ,AX 

•RESTORE 

1755 

07CD 

FB 

STI 



1756 

07CE 

C3 

RET 



1757 

07CF 


RESTORE_TICK_ 

VECTOR ENDP 








1759 

07CF 


RESTORE. INT2_ 

.3 PROC NEAR 

; RESTORE INT 2 & 3 

1760 






1761 

07CF 

FA 

CLI 



1762 



: RESTORE LEVEL 2 


1763 






1764 

0700 

A1 1016 R 

MOV 

AX,SAVE_INT2 

;GET ORIGINAL OFFSET LVL 2 


D-14 Adapter BIOS 



1765 

1766 

1767 

1768 

1769 

1770 

1771 

1772 

1773 

1774 

1775 

1776 


1783 

1784 

1785 


1790 

1791 

1792 

1793 

1794 

1795 

1796 

1797 

1798 

1799 

1800 
1801 
1802 

1803 

1804 

1805 

1806 


0703 26; A3 0028 

0707 A1 1018 R 
07DA 26: A3 002A 
070E 


070E A1 101A R 
07E1 26: A3 002C 

07E5 A1 101C R 
07 E8 26: A3 002E 


07EC AO 1007 R 

07EF E6 21 

07F1 80 3E 1010 R FC 

07F6 75 05 

07 F8 AO 1008 R 

07FB E6 A1 

07F0 

07FD FB 
07FE C3 
07FF 

07FF 


07FF 26: A1 0028 
0803 A3 1016 R 
0806 26: A1 002A 

080A A3 1018 R 


0800 26: A1 002C 

0811 A3 101A R 
0814 26: A1 002E 

0818 A3 101C R 

081 B C3 
081C 

081C 


1808 

1809 

1810 


1814 

1815 

1816 

1817 

1818 

1819 

1820 
1821 
1822 

1823 

1824 

1825 

1826 

1827 

1828 

1829 

1830 

1831 

1832 

1833 

1834 

1835 

1836 

1837 

1838 

1839 

1840 

1841 

1842 

1843 

1844 

1845 

1846 

1847 

1848 

1849 

1850 

1851 

1852 

1853 

1854 

1855 

1856 

1857 

1858 

1859 

1860 
1861 
1862 

1863 

1864 

1865 

1866 

1867 

1868 

1869 

1870 

1871 

1872 

1873 

1874 

1875 

1876 

1877 

1878 

1879 

1880 
1881 
1882 

1883 

1884 

1885 

1886 

1887 

1888 

1889 

1890 


081C FA 


0810 A1 0060 R 
0820 26: A3 0218 

0824 A1 0062 R 
0827 26: A3 021A 


082B C7 06 0060 R 0000 E 
0831 8C C8 
0833 A3 0062 R 


0836 FA 

0837 C7 06 0170 R 0000 E 
083D 8C C8 

083F A3 0172 R 


0842 26: F6 06 04A2 80 

0848 74 OD 


084A 80 3E 1012 R 04 

084F 74 06 

0851 


0851 26: 80 OE 04A2 10 

0857 


0857 26: F6 06 04A3 80 

085D 74 00 

085F 80 3E 1013 R 04 

0864 74 06 

0866 


0866 26: 80 OE 04A3 10 

086C 


086C A1 004C R 
086 F 26: A3 04A4 
0873 A1 004E R 
0876 26: A3 04A6 


087A 80 3E 1010 R FC 

087F 74 OB 


0881 C7 06 004C R 0000 E 
0887 8C C8 
0889 A3 004E R 

088C 

088C FB 
0880 C3 

088E 

088E 


MOV ES: INT2_VECT,AX 

MOV AX, SAVE_ I NT2+2 

MOV ES: INT2_VECT+2,AX 

; RESTORE LEVEL 3 

MOV AX,SAVE_INT3 

MOV ES: INT3_VECT, AX 

MOV AX,SAVE_INT3+2 

MOV ES: INT3_VECT+2,AX 

.•RESTORE I NT MASKS 


; RESTORE IT 
;GET SEGMENT 
; RESTORE IT 


GET ORIGINAL OFFSET LVL 3 
RESTORE IT 
GET SEG 
RESTORE IT 


MOV 

OUT 

CMP 

JNZ 

MOV 

OUT 

RI2: 

ST I 
RET 

RESTORE_INT2_3 


AL,SAVE_MASK 
INTAOl.AL 
PC_IO, PC3 
RI2 

AL, SAVE_MASKA 
INTBOl.AL 


ENOP 


saveI I ntIvect' ' ' PROC’ ' " ” " " 


GET ORIGINAL IMR MASK 1ST CHIP 
RESTORE IT 
IS THIS A PC 3 
JMP NO 

GET ORIGINAL MASK FOR 2ND I NT CHIP 
RESTORE IT 


near’ 


SAVE POST VECTORS FOR I NT 2 8e 3 
I NT VECTORS WILL BE RESTORED ON EXIT 
TO POST 


; I NT 2 SAVE 

MOV AX,ES: INT2_VECT 

MOV SAVE_INT2,AX 

MOV AX, ES: I NT2_VECT+2 

MOV SAVE_INT2-F2,AX 


GET I NT 2 
SAVE IT 
GET SEG 
SAVE IT 


OFFSET 


; I NT 3 SAVE 

MOV AX,ES: INT3_VECT 

MOV SAVE_INT3.AX 

MOV AX,ES:INT3 VECT+2 

MOV SAVE_INT3+2,AX 


GET I NT 
SAVE IT 
GET SEG 
SAVE IT 


OFFSET 


RET 

SAVE_INT_VECT ENOP 


SET_BIOS_INTS PROC NEAR ;A CARD TESTED OK. SET OPERATING SYSTEM 

; INTS,18,5C,LANA0,LANA1,13 
CLI ; 


;MOVE INT 18(IPL) TO 86 (BASIC) 


MOV AX, INT_18 

MOV ES: INT86_VECT,AX 

MOV AX, INT_18 +2 

MOV ES: INT86_VECT+2,AX 


GET ORIGINAL OFFSET FOR INT 18 
MOVE IT TO BASIC VECTOR 86 
GET ORIGINAL SEGMENT 
MOV IT TO 86 +2 


;NOW POINT 18 TO BIOS HANDLER 


MOV I NT_18, OFFSET REM_IPL 

MOV AX.CS 

MOV INT_18-f2,AX 


OFFSET OF BIOS HANDLER TO 18 
GET CODE SEG 
MOV SEG TO 18 


;NOW POINT THE SOFT VECTOR (INT 5C ) TO LANA BIOS 
CLI ; 

MOV LANA_BIOS_INT, OFFSET MAIN ; 

MOV AX.CS ; 

MOV LANA_BIOS_INT + 2,AX ; 

;SET INT LEV INFO FOR BIOS 
; LANA_X_STATUS BIT 4=0= I NT 2, BIT 4=1= I NT 3 

;IS LANAO ACTIVE? 


TEST BYTE PTR ES: LANA_0_STATS, 80H ; LANAO ACTIVE ? 

JZ SBI_2 ;JMP NOT ACTIVE 

;SET LANA 0 INT FLAG FOR BIOS 

CMP LANA_0_INT,04 ;IS LANA 0 ON LEVEL 2 7 

JZ SBI_2 ;JMP YES, LEAVE BIT 04 = 0 

SBI_1 ; 

;SET LANA 0 FOR LEVEL 3 


OR BYTE PTR ES: LANA_0_STATS, I NT3_FLAG 


SBI_2: 


SBI_3: 


;ANY INT LEVEL FOR LANA 1? 

TEST BYTE PTR ES: LANA_1_STATS. 80H ; LANA 1 ACTIVE ? 

JZ SBI_3A ;JMP NO 

CMP LANA_1_INT,04 ; LEVEL 2 ACTIVE ON LANA 1 ? 

JZ SBI_3A ;JMP YES .LEAVE BIT 4=0 

;SET LANA 1 FOR INT 3 

OR BYTE PTR ES: LANA_1_STATS, I NT3_FLAG 


;MOVE THE HARD FILE INT VECTOR TO 
;LANA RESERVED LO MEMORY 


MOV 

MOV 

MOV 

MOV 


AX,HARD_FILE_BIOS 
ES: LANA_1_STATS + 1,AX 
AX,HARD_FILE_BIOS +2 
ES:LANA_1_STATS + 3,AX 


;GET OFFSET 
;MOV TO LANA AREA 
;GET CS 

;MOV TO LANA AREA 


;ARE WE 


ON A PC 3 


CMP PC_ID,OFCH 

JZ SBI_4 


;FC=3 


;JMP YES 


; REDIRECT HARD FILE SOFT INT 13 
; CALLS TO DISKETTE AND HARD FILE DONE THRU 13 

MOV HARD_FILE_BIOS,OFFSET HARD_FILE ; INT13 HANDLER 

MOV AX, CS ; 

MOV HARD FILE_BIOS 2,AX ;CODE SEG 


RET 

SET_BIOS_INTS 


SET_UP_TIME_TICK 


save' t'imer' f Ick' I nt' vector' and' " " " " 


Adapter BIOS D-15 



; REDIRECT THE VECTOR TO LANA 


1892 

1893 

1894 

1895 

1896 

1897 

1898 

1899 

1900 

1901 

1902 

1903 

1904 

1905 

1906 

1907 

1908 

1909 

1910 

1911 

1912 

1913 

1914 

1915 

1916 

1917 

1918 

1919 

1920 


1924 

1925 

1926 

1927 

1928 

1929 

1930 

1931 

1932 

1933 

1934 

1935 

1936 

1937 

1938 

1939 

1940 

1941 

1942 

1943 

1944 

1945 

1946 

1947 

1948 

1949 

1950 

1951 

1952 

1953 


1954 

1955 

1956 

1957 

1958 

1959 

1960 

1961 

1962 

1963 

1964 

1965 

1966 

1967 

1968 

1969 

1970 

1971 

1972 

1973 

1974 

1975 

1976 

1977 

1978 

1979 

1980 


1985 

1986 

1987 

1988 

1989 

1990 

1991 

1992 

1993 

1994 

1995 

1996 

1997 

1998 

1999 

2000 
2001 
2002 

2003 

2004 

2005 

2006 

2007 

2008 

2009 

2010 
2011 
2012 

2013 

2014 

2015 

2016 


SAVE BIOS VECTOR 1C— 


088E 33 CO 

0890 A3 100D R 
0893 A2 100F R 
0896 26: A1 0070 R 

089A A3 1009 R 
089D 26; A1 0072 R 

08A1 A3 100B R 


XOR AX, AX 

MOV TICKS, AX 

MOV T_0_FLAG,AL 

MOV AX,ES:TICK_INT 

MOV SAVE_TICK_INT,AX 

MOV AX, ES:TICK_INT +2 

MOV SAVE_TICK_INT +2, AX 


CLEAR THE TICK COUNT 

CLEAR THE TIME OUT FLAG 

GET BIOS OFFSET FOR 1C 

SAVE IT, PGM WILL RESTORE ON EXIT 

GET THE BIOS CS FOR I NT 1C 

SAVE IT 


; REDIRECT TIMER TICK VECTOR TO ME 


08A4 

08A5 

08AB 

08AD 

08B0 

08B1 

08B2 

FA 

C7 06 0070 R 0906 R 

8C C8 

A3 0072 R 

FB 

C3 

CLI 

MOV 

MOV 

MOV 

STI 

RET 

SET_UP_TIME_T 

TICK INT, OFFSET TICK 
AX,CS 

TICK_INT +2, AX 

CK ENDP 

;DONT LET ANY INT IN 

IT ; OFFSET OF LANA 1C HANDLER 

;LANA CS 

;1C NOW POINTS TO LANA 
;LET INT IN 

08B2 


SET VECT 2 3 

PROC NEAR 


08B2 

FA 

CLI 



08B3 

26: C7 06 0028 06AC R 

MOV 

ES: INT2 VECT, OFFSET 

NT 2 ;INT HANDLER FOR LEVEL 2 

08BA 

26: 8C OE 002A 

MOV 

ES:INT2_VECT + 2,CS 


08BF 

26: C7 06 002C 06D2 R 

MOV 

ES:INT3 VECT, OFFSET 

NT 3 ;INT HANDLER FOR LEVEL 3 

08C6 

26: 8C OE 002E 

MOV 

ES: INT3 VECT + 2,CS 


08CB 

FB 

STI 



08CC 

C3 

RET 



08CD 


SET_VECT_2_3 

ENDP 


08CD 


SET WD CNT 

PROC NEAR 

' Iset'dma's' f6r'2' byte'xfer' """""" 

08CD 

E6 OC 

OUT 

DMA + OCH,AL 

; CLEAR F/F..AL DOSN"T MATTER 

08CF 

EB 00 

JMP 

SHORT $ + 2 

; delay 

08D1 

BO 01 

MOV 

AL.01 

; COUNT N-1 

08D3 

E6 07 

OUT 

DMA + 7,AL 

; WRITE THE LSB 

08D5 

EB 00 

JMP 

SHORT $ + 2 

; DELAY 

08D7 

32 CO 

XOR 

AL,AL 

;MSB 

08D9 

E6 07 

OUT 

DMA + 7,AL 

; WORD COUNT 0002 

08DB 

C3 

RET 



08DC 


SET_WD_CNT 

ENDP 


08DC 


SPECIAL CLR ' 

PROC NEAR 


08DC 

FA 

CLI 



08DD 

BA 0363 

MOV 

DX,HOST INTR REG 


08E0 

03 D3 

ADD 

DX,BX 


08E2 

EC 


AL.DX 

;GET CURRENT REG 

08E3 

24 OC 

AND 

AL, 00001 100B 

;MASK OF INT BITS, DMA ENABLE, HCR 

08E5 

EB 00 

JMP 

SHORT $ + 2 


08E7 

EE 

OUT 

DX.AL 

;SET HIR 

08E8 

BA 0360 

MOV 

DX, STATUS REG 


08EB 

03 D3 

ADD 

DX.BX 


08ED 

EC 

IN 

AL,DX 

;GET STATUS REG 

08EE 

EB 00 

JMP 

SHORT $ + 2 

; DELAY 

08F0 

OC 80 

OR 

AL, RESET INT REQ 

;0R IN BIT TO CLEAR INT REQUESTS 

08 F2 

EE 

OUT 

DX,AL 

; CLEAR INT REQ 

08F3 

FB 

STI 



08 F4 

C3 

RET 



08F5 


SPECIAL_CLR 

ENDP 


08 F5 


START TIMER 

PROC NEAR 

; ENABLE FLAG FOR GROSS TIME OUT ‘ ‘ ‘ ‘ ' 

08 F5 

33 CO 

XOR 

AX, AX 

; RESETS TIME COUNT VALUES AND FLAGS 
;FLAG TESTED IN TICKS 

08F7 

A3 1000 R 

MOV 

TICKS, AX 

; CLEAR THE TIME COUNT 

08 FA 

A2 100F R 

MOV 

T 0 FLAG,AL 

; CLEAR THE FLAG 

08 FD 

C3 

RET 



08FE 


START_TIMER 

ENDP 


08FE 


STOp’fiMEFt'"’ 

' "pROc" " near" " " " ' 

joi SABLE FLAG FOR GROSS TIME OUT 

08FE 

FA 

CLI 


; DISABLE INT 

08FF 

33 CO 

XOR 

AX, AX 


0901 

A3 1000 R 

MOV 

TICKS, AX 

•TIMER COUNT TO ZERO 

0904 

FB 

STI 



0905 

C3 

RET 



0906 


STOP_TIMER 

ENDP 


0906 


tIck' it""'" 

PROC FAR 

; handles' the' ii MEr’ tI Ck' INt' " " "" 

0906 

50 

PUSH 


;SAVE SEGMENT REGS 

0907 

IE 

PUSH 

DS 


0908 

33 CO 

XOR 

AX, AX 


090A 

8E D8 

MOV 

ds'ax 

•ESTABLISH DS 

090C 

FF 06 100D R 

INC 

TICKS 


0910 

80 3E 1006 R 80 

;IS HOT RF TEST IN PROCESS? 

CMP RF TEST,80H 

;80=SUSPECT HOT RF 

0915 

75 OA 

JNZ 

TIO 

;JMP no hot RF TEST 

0917 

81 3E 100D R 0333 

;HOT RF TEST-HAS 45 SECONDS 

CMP TICKS.RF COUNT 

EXPIRED 

;HAS 45 SECONDS EXPIRED 

0910 

77 OC 

JA 

Til 

;JMP TIME EXPIRED -SET FLAG 

091 F 

EB 12 

JMP 

SHORT TI2 

; EXIT-TIME HAS NOT EXPIRED 

0921 

0921 

81 3E 100D R 0222 

TIO: 

; GENERAL TIME OUT TEST 

CMP TICKS.T 0 CNT 

:30 SEC'S ELASPED? 

0927 

77 02 

JA 

Til 

;JMP YES-SET TIME OUT FLAG 

0929 

EB 08 

JMP 

SHORT TI2 

; EX IT-TIME HAS NOT EXPIRED 

092B 

092B 

C6 06 100F R 80 

Til: 

;TIME 

MOV 

HAS EXPIRED SET FLAG 

T 0 FLAG, BOH 

;SET TIME OUT INDICATOR 

0930 

A3 100D R 

MOV 

TICKS, AX 

; ZERO THE TICK COUNT 

0933 

0933 

BO 20 

TI2: 

;EXIT 

MOV 

AL,EOI 

; ENABLE GENERAL INTERRUPTS 

0935 

E6 20 

OUT 

INTAOO,AL 


0937 

1 F 

POP 

DS 

; RESTORE SEGS 

0938 

58 

POP 

AX 


0939 

CF 

IRET 



093A 


TICK IT 

ENDP 


093A 


TIME OUT OR INT? PROC NEAR 

;TEST FOR A GROSS TIME OUR OR INT 

093A 

32 E4 

XOR 

AH AH 

;& RETURN WITH STATUS IN AH 
;«cAH=80= 1 NT**AH=08=T 0**AH=0=NE 1 THER 
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2017 

2018 

2019 

2020 
2021 
2022 

2023 

2024 

2025 

2026 

2027 

2028 

2029 

2030 

2031 

2032 

2033 

2034 

2035 

2036 

2037 

2038 

2039 


093C 80 3E 100F R 80 

0941 75 04 

0943 80 CC 08 

0946 C3 

0947 

0947 80 3E 1000 R 80 

094C 74 03 

094E 32 E4 

0950 C3 

0951 

0951 80 CC 80 

0954 C3 

0955 

0955 

0955 EE 

0956 C3 

0957 


Toon : 


T00I2: 


CMP 

JZ 

XOR 

RET 


T_0_FLAG,80H 
TOO I 1 
AH,08H 


1NT_OCCUR?,80H 
TOO I 2 
AH, AH 


TIME_0UT_0R_INT? 


WRT_REG PROC 

OUT DX,AL 

RET 

WRT_REG ENDP 


near' 


JMP NO GROSS TIME OUT 
SET TIME OUT FLAG 


;JMP I NT OCCUR 
;AH=00 


;SET I NT FLAG 
;AH=80 


entered’ with' i / o’ add’ i 


dx^’data' in’al 


0957 


NETWORK 

TITLE NETBIOS MAIN 


END 


ENDS 

START 


• NETBIOS. ASM 
; NETBIOS MAIN SOURCE. 


MODULE : NETWORK 
COMPONENT : NETWORK BIOS 


NETBIOS IS THE NETWORK BIOS. IT RESIDES IN A ROM. 

NETWORK SERVICES ARE THEN PROVIDED VIA THE I NT NET_INT INSTRUCTION. 
SERVICES PROVIDED ARE: 


RESET 

ADAPTER STATUS 

CANCEL 

ADD_NAME 

ADD_GROUP_NAME 

DELETE_NAME 

CALL 

LISTEN 

HANG_UP 

SEND 

CHAI N_SEND 
RECEIVE 
RECEIVE_ANY 
SESSION STATUS 


SEND_BROADCAST DATAGRAM 
RECEIVE_BROADCAST DATAGRAM 


- RESET AND RECONFIGURE NETWORK ADAPTER CARD 

- RECEIVE LOCAL OR REMOTE ADAPTER STATUS 

- CANCEL THE COMMAND STARTED BY THIS NCB 

- ADD NAME TO NAME TABLE 

- ADD A GROUP NAME TO NAME TABLE 

- DELETE NAME FROM NAME TABLE 

- OPEN A SESSION WITH A REMOTE OR LOCAL NAME 

- WAIT FOR NAME/ANYONE TO OPEN SESSION TO YOU 

- CLOSE A SESSION WITH THE GIVEN NAME 

- SEND DATA THROUGH A SPECIFIC SESSION 

- SEND TWO SEPARATE BUFFERS 

- RECEIVE DATA FROM A SPECIFIC SESSION 

- RECEIVE DATA FROM ANY SESSION SENDING TO YOU 

- RECEIVE STATUS OF ALL ACTIVE SESSIONS 
FOR YOUR NAME 

- SEND DATAGRAM TO NAME 
RECEIVE DATAGRAM FROM NAME 


- SEND BROADCAST DATAGRAM TO 
EVERYONE 

■ RECEIVE BROADCAST DATAGRAM FROM 
ANYONE 


THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


NETBIOS. LIB CONTAINS THE NETBIOS INTERFACE EQUATES AND STRUCTURES 
LANAS. INC CONTAINS THE LANA INTERFACE EQUATES AND STRUCTURES 


0000 


NETWORK SEGMENT PARA PUBLIC 'CODE' 


ASSUME CS: NETWORK 
ASSUME DS; NOTHING 
ASSUME SS:NOTHING 
ASSUME ES: NOTHING 


EXTRN LANA_0_HNDLR : NEAR 

EXTRN PROGRAM_IO_CHUNK : NEAR 

EXTRN LANA_1_HNDLR : NEAR 


LANA O'S INTERRUPT 
LANA O'S CODE TO 
LANA 1'S INTERRUPT 


HANDLER 
DO PROGRAM 
HANDLER 


I/O 


PUBLIC DMA_START_UP 

PUBLIC MAIN 

PUBLIC HARD_FILE 

PUBLIC REM_IPL 


NEAR ; COMMON RTN TO STARTUP DMA XFER'S 

NEAR ; INT 5C ENTRY POINT 

NEAR ; CHECK TO SHARE DMA WITH HARD FILE 

NEAR ; CHECK IF REMOTE I PL REQUESTED 


= OOFF 
= OOFF 


NCBNOT_DONE? EQU OFFH 

ALL_BITS EQU OFFH 


; NCB IS NOT DONE YET 


= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 


C0NF1G_CPLT_T0 
RESET_CPLT_T0 
CANCEL_CPLT_TO 
DRE_LIMIT 
GO_LIMIT 
DMA_LIMIT 
HC_L I M I T 
W_T I L_ACC 


EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 


OOOOH 

OOOOH 

OOOOH 

OOOOH 

OOOOH 

OOOOH 

OOOOH 

OOOOH 


HOW LONG TO WAIT 
HOW LONG TO WAIT 
HOW LONG TO WAIT 
HOW LONG TO WAIT 
HOW LONG TO WAIT 
HOW LONG TO WAIT 


FOR RESET TO COMPLETE 
FOR CANCEL TO COMPLETE 
FOR DATA REGISTER 
FOR GO BIT TO CLEAR 
FOR DMA TO COMPLETE 
FOR HC TO BE SET 


= OOFB 
= 00F7 
= OOFO 
= 0021 
= 00A1 
= 0028 
= 002C 
= OOOE 
= OOFC 
= FFFF 


ENABLE. I NT2 
ENABLE_INT3 
ENABLE. I NT9 
INTA01 
INTB01 
I NTR_2 
INTR.3 
PC. I D.ADD 
PC 3 

ROS.CODE 


EQU OFBH 

EQU 0F7H 

EQU OFDH 

EQU 021H 

EQU 0A1H 

EQU 028H 

EQU 02CH 

EQU OEH 

EQU OFCH 

EQU OFFFFH 


USE FOR I MR TO ENABLE INT REQ 2 
USE TO ENABLE INT 3 
FOR INTERUPT 2 NEED TO SET INT 9 
DMA CHIP 1 
DMA CHIP 2 

PHYSICAL ADDRESS FOR INT VECTOR 2 ( A*4 ) 
PHYSICAL ADDRESS FOR INT VRCTOR 3 ( B*4 ) 
OFFSET FOR PC ID 
PCS ID 

POINTER INTO ROS 


= 9080 DEV.BUSY.WAIT EQU 9080H 

= 9180 DEV.BUSY.POST EQU 9180H 


= 0013 
= 004C 


HARD. I NT 
HARD. I NT0 


EQU 013H 

EQU HARD_INT*4 


DISK I/O 

OFFSET FOR THIS INTERUPT 


EQU 18H 


ROM BASIC 
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= 0060 
= 0086 
= 0218 

= 0000 


0000 2A 

0001 49 42 40 4E 45 ,54 
42 4F 4F 54 

= 0013 
= 0013 

OOOB 00 7C 00 00 
000 F 0400 


0011 FF FF FF FF FF FF 
FF FF 

0019 FF FF FF FF FF FF 
FF FF 

0021 2C 2C 03 FF OA OA 
OA 10 

0029 FF FF FF FF FF FF 
FF FF 

0031 1A 1A OA 1A FF FF 
FF FF 

0039 FF FF FF FF FF FF 
FF FF 

0041 2A 2A 2C 1A 2A 00 
2A FF 

0049 FF FF FF FF FF FF 
FF FF 

0051 FF FF FF FF FF FF 
FF FF 

0059 FF FF FF FF FF FF 
FF FF 

0061 FF FF FF FF FF FF 
FF FF 

0069 FF FF FF FF FF FF 
FF FF 

0071 FF FF FF FF FF FF 
FF FF 

0079 FF FF FF FF FF FF 
FF FF 

0081 00 FF FF FF FF FF 

FF FF 

0089 FF FF FF FF FF FF 
FF FF 


0091 FF FF FF FF FF FF 
FF FF 

0099 FF FF FF FF FF FF 
FF FF 

00A1 2C 2C 03 FF OA OA 
OA 10 

00A9 FF FF FF FF FF FF 
FF FF 

00B1 1A 1A OA 1A FF FF 
FF FF 

00B9 FF FF FF FF FF FF 
FF FF 

00C1 2A 2A FF 1A 2A FF 
2A FF 

00C9 FF FF FF FF FF FF 
FF FF 

00D1 FF FF FF FF FF FF 
FF FF 

0009 FF FF FF FF FF FF 
FF FF 

00E1 FF FF FF FF FF FF 
FF FF 

00E9 FF FF FF FF FF FF 
FF FF 

00F1 FF FF FF FF FF FF 
FF FF 

00F9 FF FF FF FF FF FF 
FF FF 

0101 FF FF FF FF FF FF 
FF FF 

0109 FF FF FF FF FF FF 
FF FF 


0111 


0111 IE 

0112 51 

0113 52 

0114 56 

0115 57 


R0M_BASICe EQU INT_18H*4 ; PHYSICAL ADORES OF INT 18H 

INT_86H EQU 86H ; 

INT_STORAGE EQU I NT_86H*4 ; PHYSICAL ADORES OF INT 86H TO STORE VALUE OF INT 

18H 

INTERRUPT_VECTOR_SEGMENT EQU OOOOH ; SEGMENT POINTER TO LOW MEMORY 


; REMOTE I PL VALUES 

LOCAL_STAT OB ; USE TO GET LOCAL ADAPTER STATUS 

SERVER_NAME DB "IBMNETBOOT" ; USE BY RPL ROUTIONE TO GET SESSION STABLISHED Wl 

TH RPLS 

LST_4_BYTE EQU 001 3H 

MEMORY_SIZE EQU 001 3H ; LOCATION FOR MEMORY SIZE IN K-BYTES 

BOOT_LOCN DO 00007C00H ; LOCATION WHERE TO LOAD BOOT_RECORD 

T1K DW 0400H ; MULTIPLIER FOR IK BYTES 


VALID COMMANDS TABLE OFFH INDICATES NOT VALID COMMAND 
ANY OTHER VALUE INDICATES VALID COMMAND 

THIS VALUE IS USED TO INDICATE HOW MUCH OF THE NCB NEEDS 
BE SENT OVER TO LANA. 


; 0 1 2 3 4 5 6 7 

; 89ABCDEF 

COMMAND_TBL DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_08 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_10 DB 44, 44, 3, OFFH, 10, 10, 10, 16 

C0MMAND_18 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_20 DB 26, 26, 10, 26, OFFH, OFFH, OFFH, OFFH 

C0MMAND_28 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_30 DB 42, 42, 44, 26, 42, 0, 42, OFFH 

COMMAND_38 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_40 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_48 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_50 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_58 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_60 OB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_68 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_70 DB 0, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_78 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

; 0 1 2 3 4 5 6 7 

; 89ABCDEF 

COMMAND_80 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_88 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_90 DB 44, 44, 3, OFFH, 10, 10, 10, 16 

C0MMAN0_98 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_AO DB 26, 26, 10, 26, OFFH, OFFH, OFFH, OFFH 

C0MMAND_A8 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_BO DB 42, 42, OFFH, 26, 42, OFFH, 42, OFFH 

C0MMAND_B8 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_CO DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_C8 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_DO DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAN0_D8 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_EO DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

C0MMAND_E8 DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 

COMMAND_FO DB OFFH, OFFH, OFFH, OFFH, , OFFH, OFFH, OFFH, OFFH 

COMMAND_FF DB OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH, OFFH 


MAIN 

HANDLES INT NET_INT INSTRUCTIONS. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER I ACCESS 1 USAGE 

ES:BX 1 CONST 1 ADDRESS OF NCB TO PROCESS 

AL ! RESULT I NETBIOS RETURN CODE; 

1 SEE NETBIOS INTERFACE SPEC 

INTERRUPTS WILL BE MASKED BY EXECUTING THE INT INSTRUCTION. 


MAIN PROC NEAR NETBIOS MAIN HANDLER ENTRY 


SAVE <DS,CX,DX,SI,DI> 

+ PUSH DS 

+ PUSH CX 

+ PUSH DX 

+ PUSH SI 

+ PUSH Dl 
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; ESTABLISH GLOBAL ASSUMPTIONS 


0116 

0117 

011A 


one B4 00 


CLD 

MOV AX, LO_MEM_SEG 

MOV DS,AX 

; DEFAULT RETURN CODE IS NCBGOOD_RET? 
MOV AH,NCBGOOD_RET? 

; FLAG NCB AS "NOT DONE" 


STRING GO UP 

POINT TO LO_MEM_SEG LATER 
DS PTS TO LANA LO_MEM BYTES 


; CHECK FOR ANY IMMEDIATE ERRORS (& GET ADAPTOR PARMS) 


0128 26: 8A OF 

012B E8 01A5 R 

012E 80 FC 00 

0131 74 04 

0133 FB 

0134 EB 5F 90 


MOV 

CALL 


CMP 

JE 

JMP 


CL, ES: ( BX 1 . NCB_COMMANO 
CHK_STATE 

AH,NCBGOOO_RET? 

CONFIG? 

B I OS_EX I T 


SAVE COMMAND VALUE FOR LATER USE 

INITIALIZE CARD IF IT NEEDS TO BE 

CHECK FOR ERRORS 

DID EVERY THING GO OK 

YES GO AND PERFORM COMMAND 

ENABLE INTERUPTS 

LEAVE AND REPORT ERROR 


, AND 


0137 80 F9 32 

01 3A 75 06 
013C E8 02BE R 
013F EB 54 90 


CONFIG?: 


CMP 

JNE 

CALL 

JMP 


CL,NCBRESET 

CANCEL? 

CONFIG 

BIOS_EXIT 


IS IT A RESET COMMAND 
NO GO AND CHECK FOR CANCEL 
GO AND RESET AND RECONFIGURE CARD 
DONE WITH RESET THEN LEAVE 


"CANCEL" CMD? 


0142 80 F9 35 

0145 75 06 

0147 E8 03CB R 
014A EB 49 90 


CANCEL?: 


CMP 

JNE 

CALL 

JMP 


CL,NCBCANCEL 

RDRCT_DI0 

CANCEL_CMD 

BIOS_EXIT 


IS IT A CANCEL COMMAND 
NO GO AND CHECK FOR UNLINK COMMAND 
PERFORM CANCEL COMMAND 
DONE WITH CANCEL THEN LEAVE 


; IS IT CHANGE DISK I/O REDIRECTION 


0140 

014D 80 F9 70 

0150 75 06 

0152 E8 08BA R 
0155 EB 3E 90 


RDRCT_DIO: 


CMP 

JNE 

CALL 

JMP 


IS IT UNLINK COMMAND 

NO GO NAD CHECK FOR OTHER COMMANDS 

PERFORM UNLINK COMMAND 

DONE WITH UNLINK THEN LEAVE 


; IT ISA NORMAL_CMD. 

0158 E8 036B R OTHER_CMD: CALL NORMAL_CMO ; GO AND PERFORM ANY OF THE OTHER COMMANDS 

; ANY ERRORS? 


015B 80 FC 00 

015E 75 35 


CMP 

JNE 


AH,NCBGOOD_RET? 
B I OS_EX I T 


;ANY IMMEDIATE ERRORS TO REPORT 
;GO REPORT ERROR AND LEAVE 


; NOPE. IS IT A WAIT CASE? 


0160 F6 Cl 80 
0163 75 38 


TEST CL,NCBNO_WAIT ;IS IT A NO_WAIT COMMAND 

JNZ BIOS_EXIT1 ; IF IT IS LEAVE 


; YES. WELL THEN. . . WAIT. 


0165 B8 9080 
0168 CD 15 
016A FB 


MOV AX,DEV_BUSY_WAIT ; INDICATE THAT WE ARE GOING INTO A WAIT LOOP 

INT 15H 

ST I ; ENABLE INTERRUPTS IN CASE THEY ARE OFF 


; CHECK IF ANY ERRORS OCCURED 
; WHILE WATING FOR COMMAND TO COMPLETE 


016B 8A 04 
016D A8 04 
016F 74 OE 

0171 B4 40 
0173 A8 02 
0175 74 16 

0177 52 

0178 83 C2 02 

017B EC 

01 7C 8A EO 
017E 5A 


NCB_DONE?: MOV AL,DS:[SI1 

TEST AL, LANA_HARD_ERR 

JZ NCB_DONE1? 


MOV AH,NCBSYS_ERR? 

TEST AL, LANA_HARD_ERR1 

JZ CHK_EXIT_ERR 

PUSH DX 

ADD DX,DR 

IN AL,DX 

MOV AH,AL 

POP DX 


GET STATUS FOR LANA_X (X=0 OR 1) 

DID NAY HARDWARE ERRORS OCCUR 

NO ERROR GO AND KEEP WAITING FOR 

COMMAND TO COMPLETE 

ASSUME A TIMEOUT ERROR 

THEN CHECK ERROR REPORTED FROM LANA 

NO ERROR REPORT THEN IT WAS A TIMEOUT ERROR 

POINT TO DATA REGISTER 

AND GET VALUE OF ERROR REPORTED BY LANA 


017F NCB DONE1?: 

017F 26: 80 7F 31 FF CMP 

0184 74 E5 JE 


0186 26: 8A 67 01 MOV 

018A EB 09 90 JMP 


ES:BYTE PTR [ BX] . NCB_CMD_CPLT, NCBNOT_DONE? ; CHECK IF COMMAND COMPLETED 

gQ CHECK IF ANY ERRORS 

HAVE OCCURED WHILE WATING 
DONE THEN GET VALUE FOR RETURN_CODE 
GO GET READY TO EXIT 


018D 


CHK_EXIT_ERR: 


0180 50 

018E B8 9180 
0191 CD 15 

0193 FB 

0194 58 


PUSH AX 

MOV AX,DEV_BUSY_POST 

INT 15H 

ST I 

POP AX 


; INDICATE THAT WE ARE COMM I NG OUT OF WAIT LOOP 
;MAKE SURE INTERRUPS ARE ENABLE 


; ALL DONE. UPDATE RETURN CODE 


0195 26: 88 67 31 
0199 26: 88 67 01 


BI0S_EXIT: MOV 
MOV 


ES:[BX].NCB_CMO_CPLT,AH ; UPDATE COMMAND COMPLETED FIELD AND 
ES:IBX].NCB_RETCODE,AH ; UPDATE RETURN CODE FIELD 


019D 8A C4 


BIOS_EXIT1: MOV 


;MAKE SURE AL CONTAINS VALUE FOR RETURN CODE 


; RETURN 


019F 5F 
01A0 5E 
01A1 5A 
01A2 59 

01A3 IF 


RESTORE 

POP 

POP 


, DX, ex, DS> 


01A4 CF 


I RET 


END. 


01A5 


MAIN ENDP 
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CHK_STATE 

CHECKS FOR ANY IMMEDIATELY DETECTABLE PROBLEMS. 


THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER 


ACCESS 


USAGE 


CONST 

CONST 

CONST 

RESULT 

RESULT 

RESULT 

DESTROY 

VAR 


LO_MEM_SEG 
NCB e 

NCB_COMMAND 

LANA’S BASE PORT (LANA_X_SR) 6 
LANA_X_HIR PORT © 

LANA_X_STATUS © 

INTERNAL 

NETBIOS RETURN CODE: 
NCBLANA_NUM? 

NCBSYS_ERR? 

NCBLANA_LOCKED7 

NCBBAD_CMD? 


INTERRUPTS SHOULD BE MASKED ON ENTRY. 


01A5 


CHK_STATE PROC 


NEAR 


; IS NCB_LANA_NUM A VALID LANA# ? 


01A5 26: 80 7F 30 01 

01AA 76 05 

01AC B4 23 

01AE E9 02BD R 


CMP ES:BYTE PTR I BX] . NCB_LANA_NUM, 01 H ; CHECK FOR VALID LANA NUMBER 

JNA SET_LANA ; VALID LANA GO AND SETUP 

MOV AH,NCBLANA_NOM? ; BAD LANA NUMBER 

JMP CHK_EXIT ; LEAVE AND REPORT ERROR 


; YES. GET LANA’S BASE PORT, HIR PORT, & STATUS BYTE 0'S 


01B1 
01B3 
01B6 
01 B9 
01BD 
01C0 
01C3 
01C6 


74 OD 
BA 0360 
BF 0363 
8D 36 00A2 
EB 4C 90 
BA 0368 
BF 036B 
8D 36 00A3 


SET_LANA: JE 

MOV 
MOV 
LEA 
JMP 

I S_LANA_1 : MOV 
MOV 
LEA 


I S_LANA_1 

DX, LANA_0 

D I , LANA_0_H I R 

S I , DS: LANA_0_STATUS 

PRESENTO? 

DX, LANA_1 

Dl , LANA_1_HIR 

S I , DS: LANA_1 STATUS 


; IS IT LANA 1 GO AND SET UP 
;LANA_0 GET BASE ADDRESS=360H 
;LANA_0 HIR ADDRESS=363H 
; POINT TO LANA_0 STATUS 
;GO AND SEE IF IT IS PRESENT 
;LANA_1 GET BASE ADDRESS 
;LANA_1 HIR ADDRESS=36BH 
; POINT TO LANA_1 STATUS 


; INSURE LANA IS PRESENT IN MACHINE 


01CA F6 04 01 
01CD 74 03 
01CF E9 028C R 
01D2 F6 04 80 
01D5 75 05 

01D7 B4 23 
01 D9 E9 02BD R 
01 DC F6 04 10 
01DF 75 15 
01E1 50 

01E2 B8 0000 
01 E5 8E D8 

01E7 C7 06 0028 0000 E 
01 ED 8C C8 


; TEST 
JZ 
JMP 

r: TEST 
JNZ 
MOV 
JMP 
TEST 
JNZ 
PUSH 
MOV 
MOV 
MOV 
MOV 


BYTE PTR DS: [SI 1,LANA_INIT ; HAS LANA_1 BEEN INITIALIZE 
CHK_P_INIT ;NO,THEN GO AND SEE IF IT IS PRESENT 

C_ERR? ; PRESENT AND I N I T I AL I ZE, GO AND CHECK FOR ERRORS 

BYTE PTR DS: (SI ],LANA_PRESENT ; I S LANA_1 PRESENT 
L1_IRQ ;YES THEN GO AND CHECK INTERRUPT LEVEL 

AH,NCBLANA_NUM? ; BAD LANA NUMBER ERROR 

CHK_EXIT ; LEAVE AND REPORT ERROR 

BYTE PTR DS: (SI I,LANA_IRQ ;IS THIS LANA RUNNING USING INTERRUPT LEVEL 2 
L1_IRQ3 ;NO THEN IT MUST BE THREE 

AX 

AX, INTERRUPT_VECTOR_SEGMENT; 

DS,AX ; POINT TO LOW MEMORY SEGMENT 

DS:WORD PTR I NTR_2, OFFSET LANA_1_HNDLR; PO I NT TO INTERRUPT HANDLER FOR LANA_1 
AX,CS ; 


01 EF A3 002A 

01 F2 58 

01 F3 EB 54 90 


MOV DS:WORO PTR INTR_2+2,AX ;SEGMENT OF INTERRUPT HANDLER 

POP AX ; 

JMP EI2 ;GO AND ENABLE HARDWARE INTERRUPT 2 


01F6 50 L1_IRQ3: 

01 F7 B8 0000 
01 FA 8E D8 

01 FC C7 06 002C 0000 E 
0202 8C C8 
0204 A3 002E 

0207 58 

0208 EB 66 90 


PUSH 

MOV 

MOV 

MOV 

MOV 

POP 

JMP 


AX, INTERRUPT_VECTOR_SEGMENT; 

DS,AX ; POINT TO LOW MEMORY SEGMENT 

DS;WORD PTR I NTR_3, OFFSET LANA_1_HNDLR; PO I NT TO INTERRUPT HANDLER FOR LANA_1 
AX,CS 

OS: INTR_3+2,AX ;SEGMENT OF INTERRUPT HANDLER 

El 3 ; GO NAD ENABLE HARDWARE INTERRUPT 3 


020B F6 04 01 
020E 75 7C 

0210 F6 04 80 
0213 75 05 

0215 B4 23 
0217 E9 02BD R 
021A F6 04 10 
021D 75 15 

021 F 50 
0220 B8 0000 
0223 8E D8 

0225 C7 06 0028 0000 E 
022B 8C C8 
0220 A3 002A 

0230 58 

0231 EB 16 90 


PRESENTO?: TEST 
JNZ 
TEST 
JNZ 
MOV 
JMP 

L0_IRQ: TEST 

JNZ 
PUSH 
MOV 
MOV 
MOV 
MOV 
MOV 
POP 
JMP 


BYTE PTR DS:[SI J,LANA_INIT ; HAS LANA_0 BEEN INITIALIZE 

C_ERR? ; PRESENT AND I N I T I AL I ZE, GO AND CHECK FOR ERRORS 

BYTE PTR DS: (SI ),LANA_PRESENT ;IS LANA_0 PRESENT 

• ;YES THEN GO AND CHECK INTERRUPT LEVEL 

;BAD LANA NUMBER ERROR 
; LEAVE AND REPORT ERROR 

;IS THIS LANA RUNNING USING INTERRUPT LEVEL 2 
;NO THEN IT MUST BE THREE 


AH,NCBLANA_NUM? 

CHK_EXIT 
BYTE PTR DS:(SI 1,LANA_IRQ 


AX 


AX, INTERRUPT_VECTOR_SEGMENT 

DS,AX ; POINT TO LOW MEMORY SEGMENT 

DS:WORD PTR I NTR_2, OFFSET LANA_0_HNDLR; PO I NT TO INTERRUPT HANDLER FOR LANA_0 
AX,CS 

DS: INTR_2+2,AX ; SEGMENT OF INTERRUPT HANDLER 

AX 

EI2 ;GO AND ENABLE HARDWARE INTERRUPT 2 


0234 50 L0_IRC13: PUSH 

0235 B8 0000 MOV 

0238 8E D8 MOV 

023A C7 06 002C 0000 E MOV 

0240 8C C8 MOV 

0242 A3 002E MOV 

0245 58 POP 

0246 EB 28 90 JMP 


AX 

AX, INTERRUPT_VECTOR_SEGMENT 

DS,AX ; POINT TO LOW MEMORY SEGMENT 

DS:WORD PTR INTR_3, OFFSET LANA_0_HNDLR; PO I NT TO INTERRUPT HANDLER FOR LANA_0 
AX,CS 

DS:WORD PTR INTR_3+2,AX ; SEGMENT OF INTERRUPT HANDLER 
AX 

EI3 ; GO NAD ENABLE HARDWARE INTERRUPT 3 


; ENABLE 


0249 E4 21 
024B 24 FB 

024D EB 00 
024F E6 21 


AND 

JMP 

OUT 


AL, INTA01 
AL, ENABLE_INT2 
$+2 

INTA01,AL 


; ENABLE HARWARE INTERRUPT 2 


0251 IE 

0252 53 

0253 50 

0254 B8 FFFF 
0257 8E D8 

0259 58 
025A BB OOOE 
025D 8A 07 
025F 5B 

0260 1 F 

0261 3C FC 

0263 75 13 

0265 E4 A1 
0267 24 FD 

0269 EB 00 
026B E6 A1 
026D EB 09 90 


PUSH DS 

PUSH BX 

PUSH AX 

MOV AX, ROS_CODE 

MOV DS,AX 

POP AX 

MOV BX, PC_ID_ADD 

MOV AL, [ BX ] 

POP BX 

POP DS 

CMP AL, PC3 

JNZ ENABLE_GO_INT 

IN AL, I NTB01 

AND AL, ENABLE. I NT9 

JMP $+2 

OUT INTB01,AL 

JMP ENABLE_GO_INT 


; POINT TO ROS.CODE AREA 
; CHECK WHAT PC ARE WE RUNNING ON 


; I S I T A PC3 

;NO .THEN GO AND ENABLE GO INTERRUPT 


; ENABLE INTERRUPT 9 

;GO AND ENABLE GO INTERRUPT 
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0270 E4 21 
0272 24 F7 

0274 EB 00 
0276 E6 21 


AL, INTA01 
AL, ENABLE_INT3 
$+2 

1NTA01,AL 


; ENABLE HATDWARE INTERRUPT 3 


0278 

0278 50 

0279 B8 0040 

027C 8E 08 
027E 58 


ENABLE_G0. 


I NT; 
PUSH 
MOV 
MOV 
POP 


AX, L0_MEM_SEG 
OS, AX 


027r 80 OC 01 


OR 


BYTE PTR DS: [SI ),LANA_IN1T ; SET UP FLAG FOR LANA PRESENT AND INITIALIZED 


0282 87 FA 

0264 EC 
0285 EB 00 
0287 OC 01 
0289 EE 
028A 87 D7 


XCHG DI,DX ; POINT TO HIR 

IN AL,DX 

JMP $+2 

OR AL,GO ; ENABLE GO INTERRUPT 

OUT DX,AL 

XCHG DX,DI 


; HAS THIS LANA HAD A HARDWARE ERROR? 


028C 8A 04 
028E A8 04 
0290 74 11 

0292 B4 40 
0294 A8 02 
0296 74 25 

0298 52 

0299 83 C2 02 

029C EC 

029D 8A EO 
029F 5A 


C. 


.ERR?: 


MOV 

TEST 

JZ 

MOV 

TEST 

JZ 

PUSH 

ADD 

IN 

MOV 

POP 

JMP 


AL,DS:[SI ] 

AL, LANA_HARD_ERR 
LOCKED? 

AH,NCBSYS_ERR? 

AL, LANA_HARD_ERR1 

CHK_EXIT 

DX 

DX, DR 
AL,DX 



GET LANA_X_STATUS BYTE 

TEST FOR ANY HARDAWARE ERRORS 

IF NOT, CHK OTHER THINGS 

ASSUME A TIMEOUT ERROR 

CHECK FOR FATAL ERROR REPORTED BY LANA 

NO, THEN IT WAS A TIMEOUT 

POINT TO DATA REGISTER 
GET VALUE FOR FATAL ERROR 


LEAVE AND REPORT ERROR 


; IS THIS LANA LOCKED? 


02A3 

02A5 

02A7 

02A9 


A8 40 
74 05 
B4 21 


90 


LOCKED? : 


TEST 

JZ 

MOV 

JMP 


AL,LANA_LOCKED 

BAD_CMD? 

AH,NCBLANA_LOCKED? 

CHK_EXIT 


CHECK FOR INTERFACE BUSY 
IF NOT, CHK CMO CODE 
INTERFACE BUSY 
LEAVE AND REPORT ERROR 


; VALID NETBIOS COMMAND? 


02AC 

02AC 53 
02AD 8A Cl 

02AF 2E: 8D IE 0011 R 
02B4 2E: D7 

02B6 3C 00 

02B8 5B 
02B9 7D 02 
02BB B4 03 


BAD_CMD? : SAVE 

PUSH 

MOV 

LEA 

XLAT 

CMP 

RESTORE 

POP 

JGE 

BAD_CMD : MOV 


<BX> 

BX 

AL,CL 

BX,CS:COMMANO_TBL 

CS:COMMAND_TBL 

AL,0 

<BX> 

BX 


GET COMMAND VALUE 
POINT TO COMMAND TABLE 

VALID COMMAND 


LEAVE AND CONTINUE PROCESSING COMMAND 
REPORT BAD COMMAND ERROR 


; RETURN 


02BD C3 


CHK_EXIT: RET 


02BE 


CHK_STATE ENDP 


RECONFIGURES THE SPECIFIED LANA. GIVES LANA UP TO 35 SECONDS TO COMPLETE. 
THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


ACCESS 


USAGE 


CONST 

CONST 

CONST 

CONST 

DESTROY 

VAR 


LO_MEM_SEG 
LANA X_STATUS @ 

LANA'^S base PORT ( LANA_X_SR 
LANA_X_HIR PORT @ 

INTERNAL 

NETBIOS RETURN CODE: 
NCBSYS_ERR? 


) e 


INTERRUPTS SHOULD BE UNMASKED ON ENTRY. 


02BE 


CONFIG PROC NEAR 


02BE 51 
02BF 06 
02C0 57 

02C1 52 

02C2 53 


SAVE 


PUSH 

PUSH 

PUSH 

PUSH 


<CX, ES, Dl , DX, BX> 


02C3 E8 062C R 


CALL GET_I NTERFACE 


TRY TO GET HOLD OF 


LANA_X 


02C6 80 FC 00 

02C9 74 03 

02CB E9 0365 R 


CMP AH, NCBGOOD_RET? 

JZ SPIO_LANA 

JMP CONFIG_EXI 


DID WE GET HOLD OF INTERFACE 

IF SO THEN CONTINUE WITH RESET COMMAND 

LEAVE AND REPORT ERROR 


02CE 


SPI0_LANA: 


; SETUP FOR PROGRAMMED I/O FROM LANA 


02CE 87 FA 
02D0 EC 
02D1 24 C6 

02D3 OC 08 
02D5 EB 00 
02D7 EE 
02D8 OC 00 
02DA EB 00 
02DC EE 
02DD 87 D7 


JMP 

OUT 

XCHG 


DI,DX 
AL, DX 

AL, ALL_B I TS- I 0_METH0D-DD_B I T-G I 
AL, PC_TO_LANA 
$+2 
DX,AL 

AL, PROGRAMMED_IO 
$+2 
DX,AL 
DX,DI 


; PO IT TO HIR 

; GET CURRENT INTERFACE SETUP 
; MASK OFF AREA OF INTEREST 
; FIRST SET DIRECTION 


; THEN SET I/O METHOD 


; SETUP PR FOR "RE_CONFIG" PRIMARY CMD 


02DF 52 
02E0 83 C2 01 

02E3 BO 05 
02E5 EE 

02E6 26: 8A 47 02 

02EA EB 00 
02EC EE 


SAVE <DX> 

PUSH DX 

ADD DX, PR 

MOV AL,RE_CONFIG 

OUT DX,AL 

MOV AL,ES;BYTE PTR [BX].NCB_LSN 

JMP $+2 

OUT DX,AL 


POINT TO PARAMETERS REGISTER 
CMD CODE 

NUMBER OF SESSIONS 
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02ED 26: 8A 47 03 
02F1 EB 00 
02F3 EE 
02F4 EB 00 
02F6 EE 
02F7 EB 00 
02F9 EE 
02 FA EB 00 
02FC EE 
02 FD EB 00 
02FF EE 

0300 5A 


MOV AL.ESzBYTE PTR [BX1.NC8_NUM ; NUMBER OF CB'S 

JMP $+2 

OUT DX.AL 

JMP $+2 

OUT DX,AL 

JMP $+2 

OUT DX.AL ; PAD TO 7-BYTES FULL 

JMP $+2 

OUT DX,AL 

JMP $+2 

OUT DX.AL 

RESTORE <DX> 

POP DX 


0301 BO 01 
0303 EB 00 
0305 EE 


MOV AL.GO 

JMP $+2 

OUT DX.AL ;TELL LANA THAT WE HAVE A COMMAND 

; READY FOR EXECUTION 


; WAIT ON COMMAND ACCEPTED 


0306 B9 0000 


MOV CX.W_TIL_ACC 


; INDICATE WAIT TIMEOUT 


0309 EC 

030A A8 01 

030C 74 08 

030E E2 F9 

0310 E8 05A6 R 

0313 EB 3A 90 


LOOP 

CALL 

JMP 


AL.DX 

AL.GO 

CMD_ACC 

WAIT_ACC 

CATASTROPH I C_ERROR 
CONFIG_EXIT 


WAIT FOR GO TO CLEAR INDICATING CMD ACCEPTED 

IF TIME OUT THEN WE MUST HAVE HARDWARE ERROR 
LEAVE AND REPORT ERROR 


; CLEAR HCR 


0316 87 FA 

0318 EC 

0319 24 FD 

031B EB 00 
031D EE 
031E 87 D7 


CMD_ACC: XCHG 


AND 

JMP 

OUT 

XCHG 


Dl.DX 

AL.DX 

AL,ALL_BITS-HCR 

$+2 

DX.AL 

DX.DI 


POINT TO HIR 
RELEASE INTERFACE 


0320 BB OOOA 
0323 

0323 B9 0000 


; NOW WAIT UP TO A WHILE FOR RE_COFIG TO COMPLETE. 

MOV BX. 10 ; 

CONFIG_CPLTO?: 

MOV CX.CONFIG_CPLT_TO ; SET UP TIME OUT VALUE 


0326 

0326 EC 

0327 A8 01 

0329 75 OB 

032B E2 F9 
032D 4B 
032E 75 F3 

0330 E8 05A6 R 
0333 EB 1A 90 


C0NFIG_CPLT?: 

IN 


TEST 

JNZ 

LOOP 

DEC 

JNZ 

CALL 

JMP 


AL.DX 

AL.GO 

INIT_CPLT? 

CONFIG.CPLT? 

BX 

CONFIG_CPLTO? 
CATASTROPH I C_ERROR 
CONFIG_EXIT 


0336 

0336 52 

0337 83 C2 01 

033A EC 
033B 3C 41 
033D 74 07 

033F 5A 
0340 E8 05A6 R 
0343 EB OA 90 


; "INITIALIZATION COMPLETE" CMD? 
<DX> 


DX 

DX. PR 
AL.DX 

AL, I N I T_CPLT 
CPLT_OK? 

<DX> 

DX 


; DID INIT COMPLETE OK? 


0346 EC 

0347 5A 

0348 3C 80 

034A 74 03 

034C E8 05A6 R 


CPLT OK?: IN 

RESTORE 

POP 

CMP 

JE 

CALL 


AL.DX 

<DX> 

DX 

AL. INIT_CPLT_RET 
C0NFIG_EXIT 
CATASTROPH I C_ERROR 


; ACKNOWLEDGE HOST I NT + TURN Gl BACK ON 


034F 

034F EC 
0350 OC 80 
0352 EB 00 
0354 EE 


CONFIG, EXIT: 


IN 

OR 

JMP 

OUT 


AL.DX 

AL.80H 

$+2 

DX.AL 


0355 BO 00 
0357 EB 00 
0359 EE 


MOV AL.OOH 

JMP $+2 

OUT DX.AL 


035A 87 FA 

035C EC 
035D OC 01 
035F EB 00 
0361 EE 


XCHG D I . DX 

IN AL.DX 

OR AL.GI 

JMP $+2 

OUT DX.AL 


; UNLOCK INTERFACE 


0362 80 24 BF 


AND BYTE PTR OS: ( SI J . ALL_BITS-LANA_LOCKED 


0365 


; RETURN 

CONFIG_EXI : 


0365 5B 

0366 5A 

0367 5F 

0368 07 

0369 59 
036A C3 


, ES.CX> 


036B 


CONFIG ENDP 


NORMAL_CMO 

SETS UP THE NCB_RESERVE AREA Se SENDS THE NCB OVER TO THE LANA. 
THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 
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USAGE 


REGISTER 


ACCESS 


CONST 

CONST 

CONST 

CONST 

CONST 

CONST 

DESTROY 

VAR 


LO_MEM_SEG 
NCB 9 

LANA X_STATUS 9 

LANA'^S base port (LANA_X_SR) 9 
LANA_X_HIR PORT 9 
NCB_COMMAND 
INTERNAL 

NETBIOS RETURN CODE; 
NCBMAX_CMD? 

NCBSYS_ERR? 


INTERRUPTS SHOULD BE MASKED ON ENTRY (EXCEPT FOR SET_PARM). 
INTERRUPTS WILL BE UNMASKED ON EXIT. 


036B NORMAL_CI 

036B 51 + 

036C E8 062C R 
036F 80 FC 00 

0372 75 U8 

037U E8 05B9 R ADJ_NCB; 


PROC NEAR 

SAVE <CX> 

PUSH CX 

; GET AND LOCK INTERFACE 

CALL GET_ INTERFACE 

CMP AH,NCBG00D_RET? 

JNE NORM_EXIT 

; ADJUST DEFAULTS, BUFFER®, k RESERVE 
CALL ADJUST_NCB 


; TRY AND GET HOLD OF LANA_X 
; ERROR TRYING TO GET HOLD OF LANA_X 
; LEAVE AND REPORT ERROR 

AREA 

;CHANGES BUFFERS® TO 32-BIT ADDR. 


; GET NCB LENGTH (SANS POST® k RESERVE) 


0377 53 

0378 2E: 8D IE 0011 R 
037D 8A Cl 

037F 2E: D7 

0381 8A C8 
0383 B5 00 

0385 5B 


LEA 

MOV 

XLAT 

MOV 

MOV 

RESTORE 

POP 


<BX> 

BX 

BX,CS:COHMAND_TBL 

AL,CL 

CS:COMMAND_TBL 

CL, AL 

CH,0 

<BX> 

BX 


; POINT TO COMMAND TABLE 
;GET COMMAND VALUE 

;GET LENGTH OF NCB TO BE SENT OVER TO LANA 


; SETUP HIR & PR FOR "XFER NCB TO LANA" CMD 


0386 BO 01 
0388 E8 0475 R 


MOV AL,NCB_T0_LANA 

CALL SETUP_HIR_AND_PR 


; PR I MARY COMMAND INDICATING TRANSFER 
;0F NCB TO LANA 

;SET UP LANA_X HIR & PR FOR SOME PRIMARY CMD. 


; PROGRAM I/O THE NCB OVER TO THE LANA 


038B E8 053A R 


CALL PROGRAM_ I 0_NCB 


; IF ERRORS, RESTORE NCB_BUFFERe TO SEG:OFF 


038E 80 FC 00 

0391 74 29 

0393 26: FF 77 38 

0397 26: 8F 47 04 

039B 26: FF 77 3A 


CMP AH,NCBGOOD_RET? 

JE NORM_EXIT ; NO ERROR CONTINUE WITH CMD. 

PUSH ES:WORD PTR [ BX ] . NCB_RESERVE_BUFFER@ 

POP ES:WORD PTR [ BX ) . NCB_BUFFER® 

PUSH ES:WORD PTR [ BX] . NCB_RESERVE_8UFFER0+2 


039F 26: 8F 47 06 


POP ES:WORD PTR ( BX ] . NCB_BUFFERe+2 


03A3 26: 8A 07 

03A6 24 7F 

03A8 3C 17 

03AA 75 10 


MOV AL , E S : [ BX ] . NCB_COMMAND 

AND AL,7FH 

CMP AL,NCBSENDMULTI PLE 

JNZ NORM_EXIT 


GET COMMAND 

CLEAR HIGH ORDER BIT 

IF COMMAND WAS A CHAIN SEND THEN 

RESTORE SECOND BUFFER 

NO THEN CONTINUE PROCESSING 


03AC 26: FF 77 3C 
03B0 26: 8F 47 OC 
03B4 26: FF 77 3E 
03B8 26: 8F 47 OE 


PUSH 

POP 

PUSH 

POP 


ES:WORD PTR 
ES:WORD PTR 
ES:WORD PTR 
ES;WORD PTR 


BX .NCB_RESERVE_BUFFER2@ 

BX .NCB_BUFFER@+8 

BX . NCB_RESERVE_BUFFER2@+2 

BX .NCB_BUFFER@+OAH 


; RELEASE & UNLOCK INTERFACE 


03BC 87 FA 
03BE EC 
03BF 24 FD 
03C1 EB 00 
03C3 EE 
03C4 87 D7 

03C6 80 24 BF 


NORM_EXIT; XCHG 
IN 
AND 
JMP 
OUT 
XCHG 
AND 


Dl ,DX 

AL, DX ; POINT TO HIR 

AL,ALL_BITS-HCR ; TURN OFF HCR 

$+2 
DX,AL 
DX, Dl 

BYTE PTR DS:ISI ],ALL_BITS-LANA_LOCKED ;CLEAR INTERFACE BUSY FLAG 


; RETURN 


RESTORE <CX> 

03C9 59 + POP CX 

03CA C3 RET 


03CB 


NORMAL_CMD ENDP 


ASKS THE LANA TO CANCEL A NETBIOS CMD. 


THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER 

ACCESS 

USAGE 

DS 

CONST 

LO MEM SEG 

ES:BX 

CONST 

NCB ® 

DS:SI 

CONST 

LANA X STATUS 9 

DX 

CONST 

LANA'^S base port (LANA X SR) ® 

Dl 

CONST 

LANA X HIR PORT 3 

AL 

DESTROY 

INTERNAL 

AH 

VAR 

NETBIOS RETURN CODE: 

NCBCMD CNL? 

NCBMAX CMD? 

NCBSYS ERR? 


INTERRUPTS SHOULD BE MASKED ON ENTRY. 
INTERRUPTS WILL BE UNMASKED ON EXIT. 


03CB 
03CB 51 


CANCEL_CMD PROC 
SAVE 

+ POSH 


NEAR 

<CX,ES,8X> 

CX 
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GET INTERFACE (RETURN RC IF ERROR) 


0309 26: C4 5F 04 


JMP CAN_EXIT 

; PT TO NCB OF CMD TO CANCEL 


GET_NCB_C: LES 


BX, ES:[BX],NCB_BUFFER0 ;GET ADDRESS OF COMMAND TO BE CANCEL 


03E2 

03E4 

03E6 

03E8 

03EB 

03ED 

03EF 

03F1 

03F4 
03F6 
03 F8 
03 FA 

03FD 

03FF 

0401 

0403 

0406 

0408 

040A 

040C 


0418 

041A 

041C 

041E 

0421 

0423 

0425 

0427 


3C 32 
75 05 
B4 26 
EB 7A 90 

3C 35 
75 05 
B4 26 
EB 71 90 

3C 20 
75 05 
84 26 
EB 68 90 

3C 22 
75 05 
B4 26 
EB 5F 90 

3C 30 
75 05 
B4 26 
EB 56 90 

3C 36 
75 05 
B4 26 
EB 4D 90 

3C 31 
75 05 
B4 26 
EB 44 90 

3C 34 
75 05 
B4 26 
EB 3B 90 


042A 

042C 

042F 


0432 

0434 

0436 


0437 

043A 

043C 

043D 

043F 

0441 


BO 02 
26: 8A OF 
FS 0475 R 


A8 01 
74 08 
E2 F9 


CMP 

JNZ 

MOV 

JMP 

IS_CNCL; CMP 
JNZ 
MOV 
JMP 

IS_DTGRM: CMP 

JNZ 
MOV 
JMP 

IS_BOGRM: CMP 

JNZ 
MOV 
JMP 

IS_ADDNME: CMP 
JNZ 
MOV 
JMP 

IS_ADDGNME:CMP 

JNZ 

MOV 

JMP 

IS_DNME: CMP 

JNZ 
MOV 
JMP 

IS_SSTAT: CMP 

JNZ 
MOV 
JMP 


AL, NCBRESET 
I S_CNCL 
AH,NCBNO_CNL? 

CAN_EX I T2 

AL.NCBCANCEL 
I S_DTGRM 
AH,NCBNO_CNL? 

CAN_EX I T2 

AL,NCBSENDDATAGRAM 
I S_BDGRM 
AH,NCBNO_CNL? 
CAN_EXIT2 

AL.NCBSENDBROADCAST 
I S_ADDNME 
AH,NCBNO_CNL? 
CAN_EXIT2 

AL,NCBADDNAME 
I S_ADDGNME 
AH,NCBNO_CNL? 
CAN_EXIT2 

AL, NCBADDGROUPNAME 
I S_DNME 
AH,NCBNO_CNL? 
CAN_EXIT2 

AL,NCBDELETENAME 
I S_SSTAT 
AH,NCBNO_CNL? 
CAN_EXIT2 

AL, NCBSESS I ONSTATUS 
START_CAN 
AH,NCBNO_CNL? 
CAN_EXIT2 


SETUP HI R & PR FOR "ABORT NCB" 


; MOV 
MOV 
CALL 


AL,ABORT_NCB 

CL, ES: [ BX ] . NCB_COMMAND 

SETUP_HIR_AND_PR 


; IS IT A RESET COMMAND 
; NO, THEN SEE IF IT IS CANCEL COMMAND 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

;IS IT A CANCEL COMMAND 
;NO,GO AND CHECK IF SEND DATAGRAM 
; ERROR COMMAND NO VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

; I S IT SEND DATAGRAM 
;NO,GO AND CHECK IF SEND BROADCAST 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

; IS IT A SEND BROADCAST 
;NO,GO AND CHECK IF ADDNAME 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

; I S I T AN ADDNAME 
;NO,GO AND CHECK IF ADDGROUPNAME 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

;IS IT AN ADDGROUP NAME 
;NO,GO AND CHECK FOR DELETE NAME 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

; IS IT A DELETE NAME 
;NO,GO CHECK SESSION STATUS 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

; IS IT A SESSION STATUS 

;NO,GO TRY TO CANCEL OUTSTANDING COMMAND 
; ERROR COMMAND NOT VALID TO CANCEL 
; LEAVE AND REPORT ERROR 

PRIMARY CMD 

PRIMARY COMMAND FOR ABORT NCB 

SET UP LANA_X HIR AND PR FOR SOME PRIMARY COMMAND 


TELL LANA TO GO 


MOV 

JMP 

OUT 


CNCL_CPLT?: 


AL,GO 
$+2 

DX,AL ;TELL LANA COMMAND READY FOR EXECUTION 

T UPT TO "AWHILE" FOR LANA TO COMPLETE THE CANCEL 

CX,CANCEL_CPLT TO ; SET UP TIME OUT VALUE 

$+2 

AL,DX ; 

TEST AL,GO ; 

JZ CNCL_OK? ; 

LOOP CNCL_CPLT? ; 

; CATASTROPHIC ERROR. 


TIMEOUT ON CANCEL 


0449 

044B 

044D 

044F 

0451 

0453 

0455 

0458 

045A 

045C 

045E 


74 15 
3C 02 

75 05 
B4 24 

EB OD 90 
3C 04 
75 05 
B4 26 
EB 04 90 


0461 E8 05A6 R 


0464 

0466 

0467 
0469 
046B 
046C 
046E 


; IF COMPLETED WITH ERROR, 

AND AL,CPLT_CODE 

CMP AL,GOOD_RET? 

JE CAN_EXIT2 

CMP AL,BAD_PARM? 

JNZ T02 

MOV AH,NCBCMD_CNL? 

JMP CAN_EXIT2 

CMP AL,CANT_CPLT? 

JNZ OTHERR 

MOV AH, NCBNO_CNL? 

JMP CAN_EXIT2 

CALL CATASTROPHIC_ERROR 

; RELEASE 8e UNLOCK INTERFACE 


CAN_EXIT2: XCHG 

AND 

JMP 

OUT 

XCHG 

AND 


GET COMPLITION CODE 
DID IT COMPLETE OK 
EVERY THING OK THEN LEAVE 


SHOULD NOT GET OTHER COMPLITION CODES 


D I , DX ; PO I NT TO I 

AL, DX 

AL,ALL_BITS-HCR ; TURN OFF HCR 

$+2 
DX,AL 
DX, Dl 

BYTE PTR DS: (SI ],ALL_BITS-LANA_LOCKED ;CLEAR INTERFACE BUSY FLAG 


0471 

0471 

0472 

0473 

0474 


CAN_EXIT: RESTORE 

^ POP 

h POP 

I- POP 

RET 

CANCEL_CMD ENDP 


SETUP_HIR_AND_PR 
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SETS UP THE LANA'S HIR & PR PORTS FOR SOME PRIMARY CMD. 
THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER 1 ACCESS 1 USAGE 


ES:BX 


CONST ; NCB e 

CONST 1 PRIMARY COMMAND CODE 

CONST I DEPENDS ON CMD (NCB LEN OR <OLD CMD,DUMMY>) 
CONST 1 LANA'S BASE PORT ( LANA_X_SR ) @ 

CONST 1 LANA_X_HIR PORT 9 


0475 


SETUP_HIR_AND_PR PROC NEAR 


SAVE <AX> 

0475 50 + PUSH AX 

; PUT CMD CODE IN PR 


0476 52 

0477 83 C2 01 
047A EE 


SAVE <DX> 

PUSH DX 

ADD DX,PR 

OUT DX,AL 


; POINT TO PR 

;SENO PRIMARY COMMAND CODE 


; SETUP INTERFACE FOR PROGRAMMED I/O TO LANA 


047B 87 FA 

0470 EB 00 
047F EC 
0480 24 C7 

0482 OC 08 
0484 EB 00 

0486 EE 

0487 OC 00 

0489 EB 00 
048B EE 
048C 87 07 


XCHG Dl ,DX ; POINT TO HIR 

JMP $+2 

IN AL,DX 

AND AL,ALL_BITS-IO_METHOD-DD_BIT ; LEAVE Gl ON, CLR DD_BIT 

OR AL,.PC_TO_LANA ; FIRST SET DIRECTION 

JMP $+2 

OUT DX,AL 

OR AL, PROGRAMMED_IO ; THEN SET I/O METHOD 

JMP $+2 

OUT DX,AL 

XCHG DX,DI 


; XLATE NCB@ TO 32-BIT ADDR 8e PUT IN PR 


048E 51 

048F 8C CO 
0491 B1 04 
0493 D3 CO 
0495 8A C8 
0497 24 FO 

0499 03 C3 

049B 73 02 

049D FE Cl 
049F EE 
04AO 8A C4 
04A2 EB 00 
04A4 EE 

04A5 81 El OOOF 

04A9 8A Cl 
04AB EB 00 
04AD EE 
04AE 8A C5 
04BO EB 00 
04B2 EE 

04B3 59 


SAVE 

PUSH 


MOV 
ROL 
MOV 
AND 
ADD 
JNC 
I NC 
OUT 
MOV 
JMP 
OUT 
AND 
MOV 


OUT 

MOV 

JMP 

OUT 

RESTORE 

POP 


<CX> 

CX 

AX, ES 
CL, 4 
AX, CL 
CL, AL 
AL,0F0H 
AX, BX 
T0P_4_0K 
CL 

DX, AL 
AL, AH 


$+2 
DX, AL 
CX,000FH 
AL,CL 


$+2 
DX, AL 


AL,CH 


$+2 
DX, AL 


<CX> 

CX 


; PUT NCB_LENGTH/<OLD_CMD,DUMMY> IN PR 


04B4 8A Cl 
04B6 EE 
04B7 8A C5 
04B9 EB 00 
04BB EE 

04BC 5A 


MOV AL,CL 

OUT DX,AL 

MOV AL,CH 

JMP $+2 

OUT DX,AL 

RESTORE <DX> 

POP DX 


; RETURN 


04BD 58 
04BE C3 


RESTORE <AX> 

POP AX 


RET 


04BF 


SETUP_HIR_AND_PR ENDP 


DMA_START_UP 

STARTS UP A DMA XFER WITH A LANA. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER 1 ACCESS 


USAGE 


DS 

ES:DI 

DX 

CX 


AL 


CONST I LO_MEM_SEG 

CONST I ADDRESS OF REMAINING DATA 

CONST I LANA_X_HIR PORT @ 

DESTROY 1 LENGTH OF REMAINING DATA 
DESTROY I PRIMARY CMD CODE 
DESTROY I INTERNAL 


INTERRUPTS SHOULD BE MASKED ON ENTRY. 
INTERRUPTS WILL BE MASKED ON EXIT. 


04BF 

04BF 50 


DMA_START_UP PROC NEAR 

SAVE <AX> 

+ PUSH AX 

; STOP OTHERS FROM USING DMA OR THE INTERFACE (TIL DMA DONE) 


04C0 80 OE O0A1 80 

04C5 3C 01 

04C7 75 08 

04C9 80 OE 00A2 20 

04CE EB 06 90 

04D1 

04D1 80 OE OOA3 20 


BYTE PTR DS: [ LANA_HARDWARE), DMA_3_BUSY ; SET DMA BUSY FLAG 

AL,01 ;IS IT LANA_0 REQUEST 

SET_1 ;N0 THEN IT IS LANA_1 REQUEST 

BYTE PTR DS: [ LANA_0_STATUS], LANA_DMAING ; SET FLAG FOR LANA_0 DMA 

DMA_CONT 


OR 


BYTE PTR DS: [ LANA_1_STATUS], LANA_DMAING 


;SET FLAG FOR LANA_1 DMA 


04D6 


DMA_CONT : 


; MASK DREQ_3 WHILE SETTING UP DMA 
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04DA 
04DC 
04DF 
04E1 
04E3 
04 E6 
04E8 


04 EA 
04EC 
04EE 


04 FO 
04F1 
04F3 
04F5 
04F7 
04 F9 


04FB 

04FD 

0500 

0502 

0504 

0507 

0509 
050B 
0500 
050F 
051 1 
0513 
0515 
0517 
0519 


051B 

051C 

051E 

051F 

0521 

0524 

0526 

0528 

052B 

0520 

052E 

0530 

0532 


0533 

0535 

0537 


BO 43 
80 FC 44 
74 05 
OC 04 
EB 03 90 
OC 08 
E6 OB 


49 

8A Cl 
E6 07 
8A C5 
EB 00 
E6 07 


8C CO 
B9 0004 
03 CO 
8A C8 
80 El OF 
24 FO 

03 C7 
12 CO 
E6 06 
8A C4 
EB 00 
E6 06 
8A Cl 
EB 00 
E6 82 


EB 00 
EC * 

24 C7 
80 FC 44 
74 05 
OC 00 
EB 03 90 
OC 08 
EE 


BO 03 
EB 00 
E6 OA 


; SET MOOE OF DMA_3 CHANNEL 

MOV AL,0MA_SINGLE_M0DE+DMA_CHNL_3 

CMP AH , DATA_T0_LANA 

JE DMA_READ 

OR AL,DMA_WRITE_XFER 

OUT_MODE 

AL, 0MA_REA0_XFER 
DMA_MODE,AL 


JMP 
OR 
OUT 

; CLEAR "HI/LO" FLIP/FLOP 

MAINLY FOR DELAY 
OUT ANYTHING TO DO CLR 
OUT "LENGTH OF REMAINING DATA" TO DMA COUNT REGISTER 
COUNT IS N-1 


AL,ALL_BITS 

$+2 

DMA_HI_LO_FF,AL 


DEC 

MOV 

OUT 

MOV 

JMP 

OUT 


AL,CL 

DMA_3_C0UNT,AL 

AL.CH 

$+2 

DMA_3_C0UNT,AL 


CONVERT ES:OI TO 20-BIT ADDR & OUT TO DMA BASE & PAGE REGISTERS 


MOV 

MOV 

ROL 

MOV 

AND 

AND 

ADD 

ADC 

OUT 

MOV 

JMP 

OUT 

MOV 

JMP 

OUT 

; SETUP F 

RESTORE 

POP 

JMP 


AX.ES 

CX,4 

AX, CL 

CL,AL 

CL,OOFH 

AL.OFOH 

AX,DI 

CL,CH 

DMA_3_BASE.AL 

AL,AH 

$+2 

DMA_3_BASE,AL 

AL,CL 

$+2 

DMA_3_PAGE,AL 
IR FOR DMA I 
<AX> 


AX=SEGj A<19::16>, A<15::04> ! 
CH=0, CL=ROL COUNT 
AX=SEG! A<15::04>, A<19::16> | 
CX=SEG 0, X, A<19::16> 

CX=SEg| 0, 0, A<19::16> | 

AX=SEGi A<15::04>, 0 j 


AX=REAL| A<15::00> i 
CX=REALJ A<19::16> i 
OUT A<07::00> 


; OUT A<15: :08> 


& CF=SEGMENT ADJ . 


; OUT A<19: : 16> 
NO I GATED DIRECTION 


$+2 
AL,DX 

AL, ALL_B I TS- I 0_METHOO-DD_B I T 
AH,DATA_TO_LANA 
TO_LANA 
AL, LANA_TO_PC 
SET_DD 

AL, PC_TO_LANA 
DX,AL 

AL,DMA_IO+TCI 
IMP $+2 

)UT DX,AL 

UNMASK DREQ_3 TO START DMA 


JMP 

OR 

OUT 


CH WAY ARE WE GOING 
; GOING TO LANA 

; ENABLE DIRECTION LANA_TO_PC 
;G0 INDICATE DIRECTION 
; ENABLE DIRECTION PC_TO_LANA 


MOV 

JMP 

OUT 

; RETURN 
RET 

DMA_START_UP ENOP 


AL,OMA CHNL 3 
$+2 

DMA_MASK_CHNL,AL 


PROGRAM. I 0_NCB 

PROGRAM t/O’S THE NCB OVER TO THE LANA. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER 

! ACCESS 

OSAGE 

DS 

! CONST 

LO MEM SEG 

ES:BX 

1 CONST 

NCB @ 

DS:SI 

! CONST 

LANA X STATUS @ 

DX 

! CONST 

LANA'^S base port (LANA X SR ) 6 

Dl 

! CONST 

LANA X HIR PORT @ 

CX 

! DESTROY 

NCB LENGTH (SANS POST§ & RESERVE) 

AL 

! DESTROY 

INTERNAL 

AH 

! VAR 

NETBIOS RETURN CODE: 


NCBSYS.ERR? 


INTERRUPTS SHOULD BE UNMASKED ON ENTRY. 


053A 
053A 53 

053B 80 OC 08 


PROGRAM. I 


O.NCB PROC NEAR 

SAVE <BX> 

PUSH BX 

; SET "XFERRING NCB TO LANA" FLAG 

OR BYTE PTR DS: [ S I ] , LANA.GETT I NG.NCB 

; SETUP FOR XFER 


053E IE 
053F 56 

0540 57 

0541 50 

0542 52 

0543 8C CO 

0545 8E D8 
0547 8B F3 
0549 8B FA 
054B 83 C2 02 

054E 84 10 


SAVE 

POSH 

PUSH 

PUSH 

PUSH 

PUSH 


MOV 

MOV 

MOV 

MOV 

ADD 

MOV 


<DS,SI 

DS 

SI 

Dl 

AX 


, D I , AX, DX> 


AX,ES 

DS,AX 

SI,BX 

DI,DX 

DX,DR 

AH,DRE 


DSiSI = NCB e 

Dl = LANA.X.SR PORT @ 

DX = LANA.X.DR PORT 9 

AH = FLAG TO TEST 


; PUT 1ST 2 BYTES OF NCB INTO DR (ASSUMES ROOM FOR 2) 
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0550 AC 

0551 EE 

0552 AC 

0553 EB 00 


84 C4 
74 OB 
87 07 


87 FA 
E2 F3 
EB 14 90 


0565 

0567 

0568 
056A 
056C 
056E 
056F 
0570 
0572 
0574 


0577 

057A 

057B 

0570 

057F 

0580 

0582 

0583 

0584 

0585 

0586 

0587 


058A 

058A 5A 
058B 58 

058C 5F 
0580 5E 
058E IF 
058 F B9 0000 
0592 F6 04 08 


0599 EB 06 90 


05A1 E8 05A6 R 


05A4 

05A4 5B 
05A5 C3 


LODSB 

OUT 

LOOSB 

JMP 

OUT 

SUB 

; SAY GO 


DX, AL 

$+2 

OX,AL 

CX,2 


;WRIET TO OATA RAGISTER A BYTE 


; ANOTHER BYTE 


DATA_ROOM? 

GOT_ROOM: 


; CHECK 
JMP 

TEST 

JZ 

XCHG 

LODSB 

OUT 

XCHG 

LOOP 

JMP 


01 ,DX 
$+2 
AL,DX 

AL,NOT (CPLT_CODE+HC) 
AL,GO 
$+2 
DX, AL 

F ROOM FOR ANOTHER BYTE NOW 


; POINT TO SR 


kIT FOR ROOM FOR NCB BYTE 


MOV 

IN 

TEST 

JNZ 

DEC 

JNE 

RESTORE 

POP 

POP 

POP 

POP 

POP 


; CHECK IF ROOM FOR ANOTHER BYTE 

;N0 ROOM GO WAIT UNTIL ROOM AVAILABLE 

; POINT TO DATA REGISTER 

;SEND A BYTE 
; POIT TO SR 

;G0 SEE IF WE CAN SEND ANOTHER BYTE 
;G0 WAIT FOR GO TO CLEAR 


;SET TIME OUT VALUE 


; WAI 

RESTORE 

POP 

POP 

POP 

POP 

POP 

MOV 

TEST 

JZ 


OS 

NCB_ERROR 
FOR GO TO CLEAR 
<DX,/ 


DX 


OS 


PROG_EXIT: 


CX,GO_LIMIT 

BYTE PTR DS: [ SI ], LANA_GETT ING_NCB 
OK_CPLT? 

CLR_NOW? 

JMP NCB_ERROR 

; HOW DID THE XFER COMPLETE? 

TEST DS:BYTE PTR [ S I ] , CPLT_CODE 

JZ PROG_EXIT 

; ERROR XFERRING NCB TO LANA 
CALL CATASTROPHIC_ERROR 

; RETURN 

<BX> 


RET 

PROGRAM_ I 0_NCB ENDP 


BX 


CATASTROPH I C_ERROR 

HANDLES CATASTROPHIC INTERFACE ERRORS. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED; 


ACCESS 


USAGE 


CONST 

CONST 

CONST 

CONST 

DESTROY 

VAR 


LO_MEM_SEG 
LANA X_STATUS @ 

LANA'^S BASE PORT (LANA_X_SR) @ 
LANA_X_HIR PORT @ 

INTERNAL 

NETBIOS RETURN CODE: 

NCBSYS_ERR? (ALWAYS!) 


05A6 


CATASTROPH I C_ERROR PROC NEAR 


; RELEASE THE INTERFACE 


05A6 87 FA 

05A8 EC 
05A9 24 FD 

05AB EB 00 
05AD EE 
05AE 87 07 


XCHG Dl.DX ; POINT TO HCR 

IN AL,DX 

AND AL, ALL_BITS-HCR ; CLEAR HCR 

JMP $+2 

OUT DX,AL 

XCHG DX,DI 


; SET HARDWARE ERROR FOR THIS LANA 


05B0 80 OC 04 


OR BYTE PTR DS : [ S I ] , LANA_HARD_ERR ;SET FLAG HARDWARE ERROR IN LANA_X 


05B3 80 24 BF 

05B6 B4 40 
05B8 C3 


; UNLOCK INTERFACE 

AND BYTE PTR DS: ( S I ] , ALL_B I TS-LANA_LOCKED ;CLEAR INTERFACE BUSY FLAG 

; RETURN 

MOV AH,NCBSYS_ERR? ; REPORT TIMEOUT ERROR 

RET 


05B9 


CATASTROPH I C_ERROR ENDP 
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CHANGES BUFFER© TO 32-BIT ADDR. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


SETUP NCB RESERVE AREA 


[ BX ] . NCB_RESERVE_NCB0, BX 
( BX] . NCB_RESERVE_NCB@+2, ES 
ES: ( BX J . NCB_BUFFER@ 

[ BX ] . NCB_RESERVE_BUFFER@, AX 
ES: [BXJ.NCB_BUFFER@+2 
1 BX] . NCB_RESERVE_BUFFER@+2. AX 


TO RESTORE SEG:OFF TYPE ADDR ON CPLT 


26: 03 47 04 
12 CD 

26: 89 47 04 
26: 89 4F 06 


AX, ES:WORD PTR [ BX ] . NCB_BUFFER@ 
CL,CH 

ES:W0RD PTR [BX].NCB_BUFFER0,AX 
ES:WORD PTR (BX].NCB_BUFFERe+2,CX 


AX=SEG5 A<19::16>, A- 
CH=0, CL=R0L COUNT 
AX=SEGj A<15::04>, A- 


CL,7FH 

CL,NCBSENDMULTI PLE 
ADJUST_NCB_EXIT 


MASK OFF HIGH ORDER BIT 
IS COMMAND IS MULTIPLE SEND 
NO THEN LEAVE 


05FB 26: 8B 47 OC 

05FF 26: 89 47 3C 

0603 26: 8B 47 OE 

0607 26: 89 47 3E 


060B 26: 8B 47 OE 

060F B9 0004 
0612 D3 CO 
0614 8A C8 
0616 80 El OF 


061B 26: 03 47 OC 

061 F 12 CD 
0621 26: 89 47 OC 
0625 26: 89 4F OE 


AX, ES: [ BX J . NCB_BUFFER@+8 

ES: ( BX) . NCB_RESERVE_BUFFER20, AX 

AX, ES: ( BX] . NCB_BUFFER0+OAH 

ES: [BX].NCB_RESERVE_BUFFER2e+2,AX 


; CHANGE BUFFER© TO 32-Br 


X,ES:WORD PTR [ BX] . NCB_BUFFER©+8 


OTHERWISE TAKE CARE OF SECOND BUFFER ADO 
TO RESTORE SEG:OFF TYPE ADDR ON CPLT 


AX=SEG] A<19::16>, A<15::04> 
CH=0, CL=ROL COUNT 
AX=SEGi A<15::04>, A<19: : 16> 
CX=SEG| 0, X, A<19::16> 

CX=SEG 0, 0, A<19::16> 

AX=SEGi A<15::04>, 0 


LO_MEM_SEG 
LANA X.STATUS © 

LANA^S BASE PORT (LANA_X_SR) © 
LANA_X_HIR PORT © 

NCB_COMMANO 

INTERNAL 

NETBIOS RETURN CODE: 
NCBMAX_CMD? 

NCBSYS_ERR? 


LOCK INTERFACE & ENABLE INTERRUPTS 


iING, GIVE IT A CHANCE TO I 
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WAI T_ON_DMA 

WAIT UP TO "X" FOR LANA TO FINISH DMAING. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER ! ACCESS I USAGE 

DS:SI 1 CONST ! LANA_X_STATUS @ 

AH ! VAR : NETBIOS RETURN CODE: 

: NCBSYS_ERR? 

INTERRUPTS SHOULD BE UNMASKED ON ENTRY. 


0688 WAIT_ON_DMA PROC NEAR 

SAVE <CX> 

0688 51 + PUSH CX 

; SETUP DMA TIME LIMIT 

0689 B9 0000 MOV CX, DMA_LIMIT ; SET UP TIMEOUT VALUE 

; IS LjANA DMA DONE YET? 

068C F6 04 20 DMA_DONE?: TEST BYTE PTR DS: ' S I ] , LANA_DMA I NG ;IS LANA_X DONE DMAING 

068 F 74 04 JZ WAIT_EXIT ; I F SO, LEAVE 

0691 E2 F9 LOOP DMA_DONE? ;WAIT SOME MORE 

; TIMEOUT ON DMA WAIT 

0693 B4 40 MOV AH, NCBSYS_ERR? ; I F TIMEOUT WAITING FOR DMA TO 

; COMPLETE REPORT ERROR 

; RETURN 

0695 WAIT_EXIT: RESTORE <CX> 

0695 59 + POP CX 

0696 C3 RET 

0697 WAIT_ON_DMA ENDP 


HARD_FILE: 

THIS ROUTINE ALLOWS THE SHARING OF DMA CHANNEL 3 BETWEEN LANA 
AND HARD_DISK ON PCXT. 

I NT 13H IS SETUP TO POINT TO HERE ON PCI AND PCXT 
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0697 FB 

0698 1 E 

0699 50 

069A B8 0040 
0690 8E 08 
069F 58 


HARD_FILE PROC 


PUSH 

PUSH 

MOV 

MOV 


; POINT TO SEGMENT 40H 


; CHECK FOR BUSY DMA 


06A9 
06AE 
06B0 
06B1 
06B3 
06 B4 
06B5 
06B8 
06 BA 
06BB 
06BF 
06C2 
06C6 
06C9 


80 36 00A2 
80 OC 04 
80 36 00A3 
80 OC 04 


TRY_DMA_3H: TEST 
JZ 
DEC 
JNZ 
PUSH 
PUSH 
MOV 
MOV 


TRY_DMA_3H 


;SET UP TIMEOUT VALUE 


;WAIT SOME MORE 
; POINT TO SEGMENT 40H 


SI,DS:LANA_0_STATUS ; 

BYTE PTR DS:[SI ],LANA_HARD_ERR ;IF TIMEOUT REPORT ERROR ON LANA_0 
SI ,DS:LANA_1_STATUS ; 

BYTE PTR DS:(SI ],LANA_HARD_ERR ;AN0 LANA_1 

OS ;THEN GO AND PERFORM DISK REQUEST 


80 OE 00A1 80 


FF IE 00A4 
9C 

80 26 00A1 7F 


06D0 

06D1 

0602 

06D6 

0607 

06DC 

06DD 


06DE EB 08 90 

06E1 9C 
06E2 FA 
06E3 FF IE OOAt 
06E7 IF 

06E8 

06E8 

06E8 

06E8 CA 0002 
06EB 


06EB 

06EC 

06ED 


06EE 

06F1 

06F3 

06F6 

06F8 

06FB 

06FD 

0700 

0702 

0705 

0707 

0707 

0709 

070A 

070D 

070D 

070E 

070F 

0712 

0714 

0719 

071A 

071B 

071D 

071E 

071F 

0722 

0724 

0725 

0726 

0727 
072B 
072C 

072F 

072F 

0730 

0731 


80 FC 05 
74 14 
80 FC 06 
74 OF 
80 FC 07 
74 OA 
80 FC OA 

74 05 

80 FC OB 

75 06 


B4 01 
F9 

E9 0895 R 


GET_DMA_3H: POP 


CALL 

PUSHF 

AND 

POPF 

POP 

JMP 

DISKETTE: PUSHF 

CL I 
CALL 
POP 

HARD_FILE_END: 
HARD_FILE ENDP 
DUMMY PROC 

RET 

DUMMY ENDP 


BYTE PTR DS: [ LANA_HARDWARE],DMA_3_BUSY ;SET DMA BUSY FLAG 


DWORD PTR DS: [ LANA_HARD_INT] ;G0 SERVICE HARD DISK REQUEST 
BYTE PTR DS: [LANA_HARDWARE],ALL_BITS-DMA_3_BUSY ; RELEASE DMA 


HARD_FILE_END 


DWORD PTR DS: [LANA_HARD_INT] ; GO PERFORM DISKETTE REQUEST 


RIPL_INT13:REDIRECTED INTERRUPT 13H FOR REMOTE I PL 

THIS ROUTINE SENDS ALL REGISTERS USED FOR I NT 13H ACROSS THE 
TO SOME FORM OF A DISKETTE SERVER THAT WILL HANDLE THIS REQUESTS 


RIPL_INT13 PROC 


SAVE <DS,SI,DI> 

PUSH DS 

PUSH SI 

PUSH Dl 

; CHECK FOR I NT 13H REQUEST NOT SUPPORTED 


BAD_CMO_l 13 
AH, 06 

BAD_CMD_ I 1 3 
AH, 07 

BAD_CMD_I13 
AH,OAH 
BAD_CMO_ 1 1 3 
AH,OBH 
DO_REQUEST 


BAD_CMD_ 113: 


DO_REQUEST: 


F6 06 00A1 40 


PUSH 

PUSH 

MOV 

MOV 

TEST 

POP 

POP 

JNZ 

PUSH 

PUSH 

MOV 

MOV 

POP 

PUSHF 

CLI 

CALL 


SAVE 

PUSH 

PUSH 

PUSH 


Rl PL_INT13_EXIT 


DS 


IS IT A READ LONG 

YES, GO REPORT INVALID COMMAND 

IS IT A WRITE LONG 

NO, GO AND PERFORM REQUEST 


; ERROR BAD COMMAND 

;SET CARRY FLAG TO INDICATE ERROR 

;G0 REPORT ERROR 


AX, LO_MEM_SEG ; PO I NT TO SEGMENT 40H 

DS,AX ; 

BYTE PTR DS:[LANA_HARDWARE],ACTV_RIPL ;IS REMOTE I PL ACTIVE 

AX 

DS 

RDIR ; YES, THEN REDIRECT I NT 13H REQUEST 


; POINT TO SEGMENT 40H 


AX 


DWORD PTR DS:[LANA HARD_INT] ; HANDLE I NT 1 3H LOCALLY 
DS 

END_RDRC ;DONE THEN LEAVE 

<AX,BX, ES> 

AX 

BX 

ES 
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; CALCULATE ADDRESS FOR NCB AND BUFFER USED BY RPL 


rZ9 8B C3 
r3B 05 0041 
r3E 8B FO 

790 26: 89 47 04 

?44 8C CO 
?46 26: 89 47 06 

74A 26: C7 47 08 OOOB 


ES:1BX1.NCB_C0MMAND,NCBSEND;SET NCB WITH SEND COMMAND 

^!lEN_NCB ; BUFFER AREA LOACTED NEXT TO NCB 

SI ,AX 

ES: (BX).NCB_BOFFERe,AX 


ES:WORD PTR (SI +6), AX 


ES:WORD PTR [SI ),AX 


80 FC 02 
75 6C 

26: C6 07 15 
8B C6 

26: 89 47 04 
8C CO 

26: 89 47 06 
26: C7 47 08 OOOB 


: ISSUE A CALL TO NETBIOS TO PERFORM THE SEND 


ES:(BX).NCB_RETCODE,NCBGOOD_RET? ;DIO IT COMPLETE OK 


;YES THEN GO 00 A RCV FOR A REPLY 
; OTHERWISE SET CARRY B I T TO INDICATE ERROR 
;SET RETURN CODE TO ATTACHMENT FAILED TO REPONO 

; LEAVE AND REPORT ERROR 


ES; (BX1.NCB_BUFFER@,AX 
AX, ES 

ES : ( BX ) . NCB_BO F F ERe+2 , A> 
ES: [ BX] . NCB_LENGTH, 1 1 


26; 80 7F 01 00 
26: 8B 04 
75 03 
E9 087F R 


ES: ( BX) . NCB_RETCODE, NCBGOOO_RET? 
AX, ES: WORD PTR (SI) 

MSG_INCPLT? 

END_RDRC_E 


AH,80H 
AL, OOH 
END_RDRC_E 


(BX].NCB_BUFFER@,AX 
ESrWORD PTR (SI+6] 

[ BX) . NCB_BUFFER@+2, A> 
ES;WORO PTR [SI] 


[ BX 1 . NCB_LENGTH, AX 


MESSAGE INCOMPLETE 
YES, THEN GO AND DO OTHER RCV 
OTHERWISE SET CARRY BIT TO I ND 
SET RETURN CODE TO ATTACHMENT 1 
LEAVE AND REPORT ERROR 


ES: [ BX) .NCB_RETCODE,NCBGOOD_ 
AX, ES: WORD PTR [SI) 

ERROR_R? 


RET? ;DID IT COMPLETE OK 


26: 89 47 04 
26: 8B 44 06 
26: 89 47 06 
26: 8B 04 
B4 00 
B1 09 
03 CO 

26: 89 47 08 


; LEAVE AND REPORT ERROR 

; IS IT A WRITE DATA 
;CHECK FOR OTHER REQUESTS 
); YES, THEN SEND DATA TO BE USED FOR V 


ES:[BX).NCB_BUFFER@,AX 
AX,ES:WORD PTR [SI+6) 
ES; [ BX] .NCB_BUFFER0+2,/ 
AX, ES:WORD PTR [SI ) 

AH, 00 


ES : [ BX ) . NCB_LENGTH , A. 


ES: [ BX) . NCB_RETCODE, NCBGOOD_RI 


ISSUE A CALL TO NETBIOS 


;N0 THEN GO AND REPORT ERROR 


ES: [ BX) . NCB_COMMAND, NCBRECEIV 


26: 89 47 04 
8C CO 

26: 89 47 06 
26: C7 47 08 OOOB 


ES: [BX).NCB_BUFFERe,A 


26: 80 7F 01 00 
26; 8B 04 
75 09 
80 FC 00 


ES: [ BX ] . NCB_RETCODE, NCBGOOD_f 
AX, ES:WORD PTR [SI ) 

ERROR_W? 

AH, 00 
ENO_RDRC 
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0845 EB 3E 90 


0848 

0849 
084B 
0840 


0850 

0850 

0854 

0856 

085A 

085C 

0860 


B4 80 
BO 00 
EB 36 90 


26: 89 47 04 
8C CO 

26: 89 47 06 
26: C7 47 08 OOOB 


0866 CD 5C 


0868 

0860 

0870 

0874 

0876 

0879 

087B 


26: 80 7F 01 00 
26: 8B 04 
26: 8A 5C OA 
75 02 
80 EB 00 
74 OA 
F9 


STC 

MOV 

MOV 

JMP 


MOV 

MOV 

MOV 

MOV 


CMP 

MOV 

MOV 

JNZ 

CMP 


^ RECEIVE OF 


: ; LEAVE AND REPORT ERROR 

BYTES TO STATUS OF I NT 13H REQUEST 


ES : [ BX 1 . NCB_C0MMAND, NCBRECE I VE 


ES: [ BX] .NCB_BUFFER0, AX 


ES: ( BX] . NCB_RETCODE, NCBG000_RET? 
AX,ES:WORD PTR [SI ] 

BL,ES:BYTE PTR [SI+10] 

ERROR_W? 

BL,00 

END_RDRC 


087C EB 07 90 


087F 

087F 

0882 

0884 


END_R0RC_E: 


END_RDRC 


CMP 
JZ 
STC 

;RESTORE REGISTERS 


0895 5F 

0896 5E 

0897 1 F 


0898 CA 0002 


MOV 

MOV 

MOV 


CX,ES:WORD PTR [ S I +2 ] 
DX,ES:WORD PTR [SI+4] 
BX,ES:WORD PTR [Sl+S] 
ES,ES:WORD PTR [ S I +6 ] 


Rl PL_INT13_EXIT; 


Rl PL_!NT13 
DUMMY 1 


RESTORE <DI,SI,DS> 


ENDP 

PROC 


089B IE 
089C 51 

0890 52 

089E 50 

089F B8 0040 
08A2 8E 08 
08A4 A1 0013 


CALC_TOPM: 

LOOK IN LOW STRORAGE ( 0040H : 001 3H ) AND GET NUMBER OF 1 K-BYTES ON 
THIS MACHINE MULTIPLY BY 1024 TO GET NUMBER OF K-BYTES. 

1 K-BYTES HAVE ALREADY BEEN SUBTRACTED FROM THIS VALUE TO BE USED 
FOR NCBS AND BUFFER SPACE FOR RPL. 

ES:BX WILL POINT TO BEGINNING OF THIS MEMORY SPACE 


CALC_TOPM PROC 

PUSH 

PUSH 

PUSH 

PUSH 

MOV 

MOV 

MOV 


AX, L0_MEM_SEG 

DS,AX ; POINT TO SEGMENT 40H 

AX, WORD PTR DS:MEMORY_SIZE ; LOCAT I ON WHERE MEMMORY SIZE IS RECORDED 


08A9 F7 26 OOOF R 
08AD B1 OC 
08AF D3 E2 
08B1 8E C2 
0883 8B D8 
08B5 58 


MUL 

MOV 

SHL 

MOV 

MOV 

POP 

POP 

POP 

POP 

RET 

CALC_TOPM ENDP 


;MULTYPLY BY 1024 TO GET K-BYTES 


08BD F6 06 OOA1 40 

08C2 74 10 

08C4 80 26 00A1 BF 

08C9 E8 089B R 
08CC 26: C6 07 12 
08D0 CD 5C 


SAVE 

PUSH 

PUSH 

PUSH 


BYTE PTR DS: [ LANA_HARDWARE],ACTV_RI PL ;D0 ONLY IF RPL IS ACTIVE 
END_CHG_RDRC ; NOT ACTIVE THEN LEAVE 

BYTE PTR DS:[LANA_HARDWARE],ALL_BITS-ACTV_RIPL ; CLEAR RPL ACTIVE FLAG 


08D2 B4 00 


,H, NCBGOOD_RET? 


; ASSUME GOOD RETURN 


D-32 Adapter BIOS 



}D4 5B 
5D5 07 

5D6 1 F 


RESTORE 

POP 

POP 

POP 


507 C3 


RET 


508 


CHG_RDRC ENOP 


808 

808 FB 

809 B8 0000 
80C 8E CO 

80E 26: A1 0218 

8E2 26: A3 0060 

8E6 26: A1 021A 

8EA 26: A3 0062 
SEE B8 0000 
8F1 26; A3 0218 

8F5 26: A3 021A 


USED IF PC FAILS TO BOOT FROM DISKETTE OR HARDDISK. 
THIS ROUTINE WILL TRY TO BOOT FROM THE NETWORK 
ASSUMING THAT W1 JUMPER HAS BEEN REMOVE FROM THE CARO 
OTHERWISE IT WILL GO TO ROM BASIC 


REM_ I PL 


PROC 

ST I 

MOV 

MOV 

MOV 

MOV 

MOV 

MOV 


MOV 

MOV 


NEAR 


;ENA8LE INTERRUPTS 

AX, I NTERRUPT_VECTOR_SEGMENT 
ES,AX 

AX,ES:INT STORAGE ;REST0RE INTERRUPT 18H 

ES.-ROM BASICe, AX 

AX, ES: I NT_ST0RAGE+2 

ES : ROM_BAS I C©+2 , AX 

AX,OOH 

ES:INT STORAGE, AX ; SET BACK TO ZEROS 

ES; INT_ST0RAGE+2,AX 


; CHECK FOR MEMORY IN SYSTEM AND SUBTRACT IK 
; TO BE USED BY NCBS AND BUFFER SPACE FOR RPL PROCESS 


i8F9 B8 0040 
I8FC 8E 08 
I8FE AT 0013 
1901 20 0001 

1904 A3 0013 


MOV 

MOV 

SUB 

MOV 


AX, LO MEM_SEC 
OS, AX 

AX, WORD PTR OS: MEMORY SIZE 
AX,01H 

WORD PTR DS:MEMORY_SIZE,AX 


; POINT TO SEGMENT 40H 

;GET VALUE FOR NUMBER OF K-BYTES 
; TAKE AWAY 1 K 

; RESTORE MEMORY SIZE MINUS IK 


SYSTEM 


)907 E8 089B R 


CALL 


CALC_TOPM 


; LOCATE RPL WORKING AREA 


; CLEAR NCB AREA BEFORE USING 


)90A 8B FB 
)90C B9 0041 
)90F BO 00 
5911 F3/ AA 


MOV 0 I , BX 

MOV CX,LEN_NCB 

MOV AL,00H 

REP SIOSB 


;POINT TO BEGINNING OF NCB 
; CLEAR ALL OF NCB 


; DO AN ADAPTOR STATUS TO GET NODE ID 
; IN ORDER TO FORM PERMANENT NODE NAME 


3913 26: C6 07 33 
3917 26; C6 47 OA 2A 
391C 8B C3 


MOV ES; [ BX] . NCB_COMMAND, NCBSTATUS 

MOV ES: ( BX] .NCB_CALLNAME, ; LOCAL_ADAPTER STATUS 

MOV AX, BX 


391E 05 0041 

3921 26: 89 47 04 

3925 8C CO 
0927 26: 89 47 06 

092B B8 004E 
092E 26: 89 47 08 

0932 CD 5C 


ADD 
MOV 
MOV 
MOV 
MOV 
MOV 
I NT 


AX,LEN_NCB 

ES; ( BX], NCB„BUFFER@, AX 
AX, ES 

ES: [ BX] . NCB_BUFFER@+2,AX 
AX, 78 

ES: [BX].NCB_LENGTH,AX 
NET_1NT 


;BUFFER AREA RIGHT AFTER NCB 


; MINIMUM LENGHT FO ADAPTER STATUS 


; CHECK FOR REMOTE I PL JUMPER 


0934 26: F6 44 04 40 

0939 74 03 

093B E9 09D9 R 


TEST 


JZ 

JMP 


ES.-BYTE PTR [SI 

DO^RESET 

DO_INT18 


PL_OFF 


CHECK TO SEE IF JUMPER (W1) HAS BEEN REMOVED 
TO ACTIVATE RPL 

YES, THEN GO DO A RESET FOR MAX. SESSIONS 

AND MAX. COMMANDS 

NO, THEN GOTO ROM BASIC 


; DO AN ADAPTER RESET MAX SESSION MAX COMMANDS 


DO RESET TO CONFIGURE SYSTEM FOR 
MAX. NUMBER OF SESSIONS 
AND MAX. NUMBER OF COMMANDS 

094C CD 5C INT NET_INT 


0942 

0947 


26; C6 47 02 20 
26: C6 47 03 20 




e:>; I baj. nub uummano, nobklbl i 
ES; [BX].NCB_LSN,32 
ES: [BX].NCB NUM, 32 


; TRY TO STABLISH A SESSION WITH DISKETTE SERVER 


094E 26: 8D 7F 24 

0952 26: 8B 47 04 

0956 8B FO 
0958 B9 0006 
095B 06 

095C IF 

095D F3/ A4 REP 

095F OE 

0960 IF 

0961 2E: 8D 36 0001 R 

0966 26: C6 07 10 

096A B9 OOOB 
096D 26: 8D 7F OA 

0971 F3/ A4 REP 

0973 BO FO 
0975 26: 88 47 2A 

0979 26: 88 47 2B 

097D CD 5C 


LEA Dl , ES; [ BX]. NCB_NAME+10 

MOV AX, ES: [BX] . NCB_BUFFER@ 

MOV S I , AX 

MOV CX, 06 

PUSH ES 

POP DS 

MOVSB 

PUSH CS 

POP DS 

LEA SI ,SERVER_NAME 

MOV ES: [ BX) . NCB_COMMAND, NCBCALL 

MOV CX, 1 1 

LEA DI,ES:[BX].NCB_CALLNAME 

MOVSB 

MOV AL,OFOH 

MOV ES; [BX].NCB_RTO,AL 

MOV ES:[BX].NCB_STO,AL 

INT NET_INT 


;FOR NAME USE PERMANENT NODE NAME 


;FOR CALL NAME USE "IBMNETBOOT" 


;SET TIMEOUT VALUE OF 120 SEC. 
;FOR RCV. 

;AND SEND 


097F 26: 80 7F 01 00 

0984 74 03 

0986 EB 51 90 


CMP ES; [BX] .NCB_RETCODE, NCBGOOD_RET? ; D I D THE CONNECTION COMPLETE OK 

JZ CI13 ;YES,THEN GO REDIRECT INT 13H 

JMP DO_INT18 ;OTHERWISE GO INTO ROM BASIC 


; REDIRECT INTERRUPT 13H REQUEST TO NETWORK 


0989 06 

098A FA 
098B 88 0000 

098E 8E CO 


jCLEAR INTERRUPTS WHILE WE CHANGE INT 13H 

AX, INTERRUPT_VECTOR_SEGMENT 
ES,AX 
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0997 

0998 
0990 
099E 

099F 

09A0 

09A3 

09A5 

09AA 


09AB 

09AE 

09AF 

09B1 

09B3 

09B5 

09B8 

09BA 

09BD 

09C0 

09C3 

09C5 

09C7 

09C8 

09CA 


26: C7 06 004C 06EB R 
OE 

26: 8F 06 004E 


B8 0040 
8E 08 

80 OE OOAl 40 


B4 00 
CD 13 
B4 02 
BB 0000 
8E C3 
BB 7COO 
BA 0000 
B9 0001 
BO 01 
CD 13 
59 


PUSH 

MOV 

MOV 


09CC EB OB 90 
09CF 

09CF B8 0000 
0902 8E 08 


0904 

0909 


0909 

090C 

090E 

09E1 

09E4 

09E7 

09E9 

09EA 


2E: FF 2E OOOB R 


B8 0040 
8E 08 
A1 0013 
05 0001 
A3 0013 
CD 18 


CF 


ES:HARD_INT0+2 


AX,LO_MEM SEC 
DS,AX 

BYTE PTR DS:[LANA_HARDWARE1,ACTV_RIPL 


; POINT TO SEGMENT 40H 


;SET UP FLAG TO INDICATE RPL ACTIVE 


; DO A REQUEST FOR BOOT RECORD 

MOV CX,04 

PUSH CX 

MOV 


MOV 

MOV 

MOV 

MOV 

MOV 

MOV 

MOV 


13H 

AH, 02 

BX,0 

ES.BX 

BX,7C00H 

DX,0 

CX,01 

AL, 1 

13H 


RESTORE THE IK TAKEN OUT 


REM_I PL 
NETWORK 
TITLE LANA. 


MOV 
MOV 
MOV 
ADD 
MOV 
I NT 
I RET 

ENDP 


ENDS 

END 

0 INTERRUPT HANDLER 


LANA_0 . ASM 
LANA 0 ’ S 


SET RETRY COUNT 

SAVE RETRY COUNT 

RESET DISK 

DISKETTE I/O 

READ IN A SINGLE SECTOR 

TO THE BOOT LOCATION 

BOOT LOCATION 
DRIVE 0, HEAD 0 
SECTOR 1, TRACK 0 
READ ONE SECTOR 
DISKETTE I/O 


TIMEOUT GOTO ROM BASIC 


AX, LO_MEM_SEG 
DS, AX 

AX, WORD PTR DS:MEMORY_SIZE 
AX,01H 

WORD PTR DS:MEMORY_SIZE, a; 
18H 


;G0 TO ROM BASIC 


NTERRUPT HANDLER. 


MODULE ; LANA_0_HNDLR 
COMPONENT : NETWORK BIOS 

HANDLES THE LANA_0 ( I RQ2 OR I RQ3 ) INTERRUPT. VALID REASONS FOR A LANA 
interrupt ARE: 

DMA COMPLETE 

COMMAND COMPLETE --> COULD CAUSE A NETBIOS POST 
LANA REQUEST FOR DATA FROM PC 
LANA REQUEST TO XFER DATA TO PC 


ALL REGISTERS AND FLAGS ARE PRESERVED. 

NETBIOS. LIB CONTAINS THE NETBIOS INTERFACE EQUATES AND STRUCTURES 
LANAS. INC CONTAINS THE LANA INTERFACE EQUATES AND STRUCTURES 


0000 


NETWORK SEGMENT PARA PUBLIG 'CODE' 


ASSUME CS; NETWORK 
ASSUME DS: NOTHING 
ASSUME SS: NOTHING 
ASSUME ES: NOTHING 


EXTRN DMA_START_UP : NEAR 


STARTS UP A DMA XFER WITH A LANA 


PUBLIC LANA_0_HNDLR ; NEAR 

PUBLIC PROGRAM_IO_CHUNK ; NEAR 


LANA O'S INTERRUPT HANDLER 
LANA O'S PROGRAM I/O'ER 


.LIST 


= OOFF 
= 0020 
= 0020 


ALL_BITS 

THE_8259 

EOl 


EQU OFFH 

EQU 20H 

EQU 20H 


AID TO MASKING OFF BITS 
8259 PORT TO SEND EOl CMD TO 
CMD CODE FOR EOl 


= 0000 
= 0070 


AWHILE EQU OOOOH 

CHUNK_SIZE EQU 0070H 


AMOUNT OF TIME TO WAIT ON INTERFACE 
MAX. SIZE OF A PROGRAM l/O'D "CHUNK” 


= 9180 


DEV_BUSY_POST EQU 9180H 


LANA_0_HNDLR 

HANDLES THE LANA_0 ( I RQ2 OR I RQ3 ) INTERRUPT. VALID REASONS FOR A LANA 
INTERRUPT ARE: 

DMA COMPLETE' 

COMMAND COMPLETE --> COULD CAUSE A NETBIOS POST 
L^NA REQUEST FOR DATA FROM PC 
LANA REQUEST TO XFER DATA TO PC 


ALL REGISTERS AND FLAGS ARE PRESERVED. 


0000 


LANA_0_HNDLR PROC NEAR 


D-34 Adapter BIOS 



0000 50 

0001 52 

0002 1 E 


0003 FC 

0004 B8 0040 
0007 BE 08 


SAVE <AX, OX, 0S> 

PUSH AX 

PUSH OX 

PUSH DS 

; SET UP GLOBAL ASSUMPTIONS 
CLD 

MOV AX, LO_MEM_SEG 

MOV DS,AX 


ALL STRINGS GO UP 

POINT TO LO_MEM_SEG LATER 

DS PTS TO LANA RESERVED MEMORY 


TELL THE 8259 TO START LATCHING THIS INTERRUPT AGAIN 


0000 BA 0360 
0010 EB 00 
0012 EC 


GET LANA STATUS 


DX, LANA_0_SR 


; GET THIS LANA'S STATUS PORT ADDR 


; ACKNOWLEDGE INTERRUPT TO LANA 


; I F LANA 
TEST 


S GETTING AN NCB THEN 


0021 80 26 00A2 F7 

0026 A8 06 
0028 74 7F 

002A 80 OE 00A2 04 

002F EB 78 90 


GOT NCB. SET COMPLETE CODE. EXIT 

BYTE PTR DS:iLANA_0_STATUS],ALL_BITS-LANA_GETTING_NCB 

AL,CPLT_CODE 

LANA_EX I T 

BYTE PTR DS: ( LANA_0_STATUS ) , LANA_HARD_ERR 
LANA_EXIT 

IS IN CONTROL 


0036 8A EO 
0038 BA 0363 
003B EC 
003C 24 41 

003E 22 C4 

0040 74 67 


0042 F6 C4 01 
0045 74 3B 


IGNORE UN-ENABLED INTERRUPTS 

)V AH.AL 

)V DX, LANA_0_H I R 

I AL, DX 

10 AL,TCI+GI 

ID AL,AH 

: LANA_EX I T 

INSURE THIS IS A "REAL" INTERF 
TEST 


JZ 
; MAYBE. 
TEST 


I NT_BAD 

DMA COMPLETE INTERRUPT? 


LANA_REQUEST 
RELEASE DMA 


LANA MUST BE ASKING PC TO DO A CMD 


DMA TERMINAL COUNT REACHED? 


0056 

0059 

005A 

005C 

005E 

005F 


; DISABLE DMA COMPLETE INTERRUPTS (IN CASE SOMEONE ELSE USES DMA_3 ) 

MOV DX, LANA_0_H I R ; GET CURRENT PC INTERFACE REGISTER 

IN AL,DX 

AND AL,ALL_BITS-TCI-IO_METHOD ; TURN OFF "TERMINAL COUNT" INTERRUPT ENABLE 

JMP $+2 

OUT DX,AL 

JMP CLEAR_GO 


NOT DMA COMPLETE. GET THE CODE FOR THE CMD THAT LANA REQUESTS 


LANA_REQUEST: 

MOV 


0066 

0068 

006A 

006C 


3C 44 
74 2C 
3C 42 
74 28 


; IS IT A "REQUEST DATA TO/FROM LANA" CMD? 

CMP AL, DATA_TO_LANA 

JE DATA_REQ 

CMP AL, DATA_FROM_LANA 

JE DATA_REQ 


; NOPE. 
CMP 


MAYBE A "NCB COMPLETE" THEN? 


0072 

0074 

0076 

0077 

0078 
007B 
007C 
007D 


80 OE 00A2 02 


0082 E8 0249 R 


0085 

0088 

0089 

008B 

008D 


ERROR REPORT FROM LANA 


PUSH 

MOV 

OUT 


POP DX 

OR BYTE PTR DS: ( LANA_0_STATUS ] , LANA_HARD_ERR1 

; INVALID INTERRUPT. CATASTROPHIC ERROR! 

CALL CATASTROPHIC_ERROR 

; DETERMINE WHETHER TO CLEAR GO 

MOV DX, LANA_0_SR 

IN AL.DX 

TEST AL,HC 

JZ CLEAR_GO 

JMP LANA_EXIT 

; HANDLE "NCB COMPLETE" CODE 


GET THIS LANA'S STATUS PORT VALUE 
DOES LANA OWN INTERFACE? 

IF YES, CLEAR GO 
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0090 E8 OOAD R 
0093 EB 14 90 

0096 E8 0167 R 


CMD_CPLT: CALL COMMAND_CPLT 

JHP LANA_EXIT ; CLEARS GO INTERNALLY 

; PROCESS "REQUEST DATA TO/ FROM LANA" CMD 
DATA_REQ: CALL LANA_DATA_REQ 

; DON’T CLEAR GO IF USING DMA 


0099 F6 06 00A2 20 
009E 75 09 


TEST BYTE PTR DS: [ LANA_0_STATUS) , LANA_DMA I NG 

JNZ LANA_EXIT 


; TELL LANA REQUEST IS COMPLETE 


OOAO BA 0360 
00A3 EC 
00A4 24 FE 

00A6 EB 00 
00A8 EE 


CLEAR„GO; MOV 


AND 

JMP 

OUT 


DX, LANA_0_SR 
AL, DX 

AL,ALL_BITS-GO 

$+2 

DX,AL 


GET CURRENT SR PORT VALUE 
TURN OFF THE GO BIT 


; INTERRUPT RETURN 


00A9 

00A9 1 F 

OOAA 5A 
00A8 58 


LANA_EXIT: 


RESTORE 

POP 

POP 

POP 


OOAC CF 


I RET 


OOAD 


LANA_0_HNDLR ENDP 


COMMAND_CPLT 

PROGRAM I/O'S THE NCB (OF THE COMPLETED CMD) OVER FROM THE LANA. 
IF THE NCB IS NO-WAIT TYPE, THE POST ROUTINE IS INVOKED. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER ! ACCESS 1 USAGE 

DS 1 CONST 1 LO MEMEORY SEGMENT 

DX I DESTROY 1 LANA'S PR PORT ADDR 

AX I DESTROY I INTERNAL 

INTERRUPTS SHOULD BE MASKED ON ENTRY. 

NOTE: CLEARS GO INTERNALLY. 


COMMAND_CPLT PROC 


OOAD 06 
OOAE 53 
OOAF 57 


80 OE OOA2 40 


SAVE 
PUSH 
PUSH BX 

PUSH Dl 

PUSH CX 

PUSH SI 

; LOCK INTERFACE 


NEAR 

<ES,BX,DI ,cx,si; 


OR 


ENABLE INTERRUPTS 
BYTE PTR OS: ( LANA_0_STATUS), LANA_LOCKED 


OOCO BA 0363 
00C3 EC 
00C4 24 C7 

00C6 OC 00 
00C8 EB 00 
OOCA EE 


OOCB BA 0362 
OOCE BE 0360 
00D1 B4 20 


; GET NCB'S DESTINATION ADDR & LENGTH 

CALL 
LES 

SAVE <Db 

PUSH Dl 

; SETUP INTERFACE FOR PROGRAMMED I/O FROM LANA 
MOV 
AND 


DX, LANA_0_H I R 

AL,DX ; 

AL,ALL_BITS-IO_METHOO-DD_BIT ; 
UK AL, PROGRAMMED_IO+LANA TO_PC ; 

JMP $+2 

OUT DX,AL 

; SETUP TO READ IN THE NCB FROM THE LANA 

MOV DX, LANA_0_0R 

MOV S I , LANA_0_SR 

MOV AH,ORF 

; WAIT FOR (THE NEXT) BYTE OF NCB 


GET CURRENT INTERFACE SETUP 
MASK OFF BITS OF INTEREST 
AND SET THEM AS WE WANT IT 


IZ NCB_NOT_READY 

GET AND STORE BYTE 


OODE E2 F3 
OOEO EB 18 90 


00E6 

00E6 EC 
00E7 84 C4 


OOEC 75 F8 


OOEE E8 0249 R 


STOSB 
; LOOP I 


MORE NCB TO READ 


BYTE NOT READY. WAIT UP TO ' 
10V BX, AWHILE 


NCB_N0T_READY2: 

TEST 

JNZ 

DEC 

JNE 


; TIMEOUT 
CALL 


AL,DX 

AL,AH 

GET_NCB_BYTE 

BX 

NCB_N0T_READY2 

WHILE WAITING. CATASTROPHIC ERROR! 
CATASTROPH I C_ERROR 
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; SET NCB RETURN CODE TO NCBSYS_ERR? 


oon 5B 

00E2 26: C6 47 01 40 

00F7 EB 02 90 


RESTORE <BX> ; SAVED FROM Dl 

POP BX 

MOV ES:BYTE PTR [ BX J . NCB_RETCODE, NCBSYS_ERR? 

JMP CLEANUP 


; NCB TRANSFERRED. GET NCB BASE ADDRESS 

OOFA 

OOFA 6B 


NCB_XFERD: RESTORE 


SAVED FROM Dl 


; MASK INTERRUPTS, UNLOCK INTERFACE. TELL LANA WE'RE DONE 


OOFB FA 

OOFC 80 26 00A2 BF 
0101 BA 0360 

0104 EC 

0105 24 FE 
0107 EB 00 
0109 EE 


CLEANUP: 


CL I 
AND 
MOV 
IN 
AND 
JMP 
OUT 


BYTE PTR OS: ( LANA_0_STATUS1,ALL_BITS-LANA_L0CKED 

DX, LANA_0_SR 

AL.DX 

AL,ALL_BI TS-GO 


; RESTORE BUFFER© TO SEG:OFF TYPE ADDR 

010A 26 " -- — 

010E 26 

0112 26 
01 16 26 

; IF NCB FOR MULT I PI E SEND RESTORE SECOND BUFFER© TO SEG:OFF TYPE ADDR 


89 47 04 
8B 47 3A 
89 47 06 


ES:WORD PTR [ BX ] . NCB_BUFF ER@, AX 
AX,ES:WORD PTR ( BX ] . NCB_RESERVE_BUFFER©+2 
FSrWORD PTR I BX K NCR R11FFFR0+? AX 


26: 8A 07 
24 7F 
3C 17 


MOV At , ES: [ BX] . NCB_COMMAND 

AND AL,7FH 

CMP AL.NCBSENDMULTI PLE 

JNZ UDT_RCD 


0123 26: 8B 47 3C 

0127 26: 89 47 OC 

012B 26: 8B 47 3E 

012F 26: 89 47 OE 


MOV AX,ES:WORD PTR [BX].NCB RESERVE_BUFFER2© 

MOV ES:WORD PTR ( BX ] . NCB^^BU FFER@+8 , AX 

MOV AX, ES:WORD PIR [ BX ] . NCB_RESERVE_BUF FER2@+2 

MOV ES:WORD PTR [ BX ] . NCB_BU F FER@+0AH , AX 


.•UPDATE NCB_CMD_CPLT 


0133 26: 8A 47 01 
0137 26: 88 47 31 


UDT_RCD: MOV 

MOV 


AL , ES; ( BX] . NCB RETCODE 

ES.-BYTE PTR [ BX ] . NCB_,CMD..CPLT, AL 


; DO WE POST THIS NCB? 


013B 26: F6 07 80 

013F 75 09 

0141 B8 9180 
0144 CD 15 

0146 FA 

0147 EB 18 90 


TEST ES:BYTE PTR [BX].NCB COMMAND, NCBN0_WA I T 

JNZ NO_WAIT? 

MOV AX,DEV_BUSY_POST 

INT 15H 

CL I 

JMP CMD_EXIT 


014A 26: 83 7F 2C 00 

014F 75 07 

0151 26: 83 7F 2E 00 

0156 74 09 


0158 26: 8A 47 01 

01 5C 9C 

015D 26: FF 5F 2C 


0161 

0161 5E 

0162 59 

0163 5F 

0164 5B 

0165 07 

0166 C3 

0167 


.•CHECK FOR POST ADDRESS BEIGN ZERO ( N0_WA I T, N0_P0ST ) 


NO_WAIT?: CMP 

JNZ 


ES:WORD PTR ( BX ] . NCB_P0ST@, OOOOH 
POST 


CMP ES:WORD PIR ( BX ]. NCB_P0ST@-F2 , OOOOH 

JE CMD_EXIT 


; YES. GET RETCODE & POST (AS AN INTERRUPT) 


POST : 


MOV AL, ES: ( BX] . NCB_RETCODE 

PUSHF 

CALL ES: DWORD PTR [ BX ] . NC8_POST@ 


; RETURN 


CMD_EXIT: 


RESTORE 

POP 

POP 

POP 

POP 


RET 


<SI ,CX,DI , BX, ES> 
SI 
CX 
Dl 
BX 
ES 


COMMAND_CPLT ENDP 


LANA_DATA_REQ 

SETS UP & STARTS A TRANFER OF DATA BETWEEN THE PC AND THE LANA. 

WHILE DMA IS BUSY, THE PC WILL XFER "CHUNKS" VIA PROGRAMMED I/O. 

WHEN DMA IS FREE, A DMA XFER OF THE REMAINDER WILL BE SETUP AND STARTED. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER 1 ACCESS 


USAGE 


DS 


DX 

AL 


CONST 1 LO MEMEORY SEGMENT 
DESTROY I LANA'S PR PORT ADDR 
DESTROY I CMD CODE OF LANA REQUEST 
DESTROY I INTERNAL 


INTERRUPTS SHOULD BE MASKED ON ENTRY. 


0167 

0167 51 

0168 06 

0169 57 

016A 8A EO 

016C 80 OE 00A2 40 

0171 E8 0260 R 


t_DATA_REQ PROC 

SAVE 

PUSH 

PUSH 

PUSH 


NEAR 

<CX, ES.DIO 
CX 
ES 


; SAVE CMD CODE FOR LATER 

MOV AH.AL 

; LOCK INTERFACE 

OR BYTE PTR DS: [ LANA_0_STATUS] , LANA_LOCKED 

; GET DATA'S PC ADDR & LEN 
CALL ADDR_AND_LEN 
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0174 

0177 

0178 
017A 
0170 
017F 
0181 
0184 
0186 


018E 

018F 

0192 


BA 0363 
EC 

24 C7 
80 FC 44 
75 05 
OC 08 
EB 03 90 
OC 00 
EE 


; SETUP FOR PROGRAMMED I/O (MAY LATER CHANGE TO DMA) IN THE CORRECT DIRECTION 
MOV 


AND 

CMP 

JNE 

OR 

JMP 

FROM_LANA: OR 
DIR SET: OUT 


DX, LANA_0_H I R 
AL,DX 

AL,ALL_BITS-IO METHOD-DD_B I T 

AH, DATA TO_LANA 

FROM_LANA 

AL, PROGRAMMED_IO+PC_TO_LANA 
DIR_SET 

AL, PROGRAMMED. I 0+LANA TO_PC 
DX,AL 


GET CURRENT INTERFACE SETUP 
MASK OFF AREA OF INTEREST 
IS IT TO OR FROM THE LANA? 

TO LANA 
FROM LANA 


DMA_3 BUSY? 


TRY.DMA_3: TEST 


; YEP. PROGRAM I/O A "CHUNK" 


PROGRAM. I O.CHUNK 


; CATASTROPHIC ERROR HAPPEN? 


ALLOW INTERRUPTS & HOPE THAT DMA FREES UP 


; NOPE. 
CMP 


DATA. EX IT 
MORE DATA LEFT TO XFER? 


019F 

01A2 

01A4 


01A6 
01 A9 
01AA 
01AC 
01AF 


01C1 

01C3 

01C5 


83 F9 70 
73 E3 
EB E8 


01 BO 80 26 00A2 BF 

01B5 5F 
01B6 07 

01B7 59 

01B8 C3 


YES. WORTH TRYING FOR DMA? 


CMP 

JNB 

JMP 


CX,CHUNK.SIZE 
TRY.DMA.3 
PROGRAM. 1 0 


GET.DMA.3: MOV 
PUSH 
MOV 
CALL 


SETUP & START DMA (OF REMAINING DMA) 
DX, LANA.O.H I R 


INDICATES LANA REQUESTING DMA 


01B9 56 

01 BA 50 
01BB 53 


01 BC BA 0070 
01BF 3B CA 
73 02 
8B D1 
2B CA 


01CA BA 0362 


; UNLOCK INTERFACE AND RETURN 

; AND 
RESTORE 
POP 
POP 
POP 

RET 


LANA.DATA.REQ ENDP 


PROGRAM^ I O.CHUNK 

PROGRAM I/O'S A "CHUNK" OF THE REMAINING DATA BETWEEN THE PC & LANA. 
THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED; 

REGISTER 1 ACCESS 1 USAGE 


DS 


LO MEMEORY SEGMENT 
CMD CODE OF LANA REQ 
START OF "CHUNK" IN MEMORY 
LENGTH OF REMAINING DATA 
INTERNAL 


INTERRUPTS SHOULD BE UNMASKED ON ENTRY. 


PROGRAM. I O.CHUNK PROC NEAR 

SAVE <SI,A) 

PUSH SI 

PUSH AX 

PUSH BX 


SETUP CHUNK SIZE, DATA PORT ADDR, UPDATE "REMAINING DATA" SIZE 

; THIS.CHUNK := M I N( CHUNK.SIZE, REMA I N I NG.DATA ) 


MOV 

CMP 

JNB 

MOV 

SUB 

SAVE 

PUSH 

MOV 

MOV 


DX, CHUNK.SIZE 

CX,DX 

GOT CHUNK 

DX,CX 

CX,DX 

<CX> 

CX 


REMAIN I NG.DATA := REMAI N I NG.DATA - THIS.CHUNK 


DATA TO LANA? 


01D2 8B F7 

0104 06 

01D5 IE 
01 D6 07 
01D7 IF 
01 D8 BF 0360 
01DB B4 10 
01 DD EB OA 90 


01 EO 87 FA 
01 E2 EC 
01 E3 84 C4 
01 E5 74 09 


; YEP. SETUP SOURCE PTR & PORT ADDRS 

MOV S I , D I 

SWAP ES,DS 

PUSH ES 

PUSH DS 


MOV 

MOV 

JMP 

; ROOM 

DATA ROOM?:XCHG 
IN 

TEST 


DI,LANA.O SR 
AH,DRE 

0UT.T0.LANA2 
IN DATA REGISTER? 


JZ 


OUT.TO.LANA: 


NO.ROOM 

STUFF BYTE INTO DATA REGISTER 


ROOM IN DATA REGISTER? 
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; CATASTROPHIC_ERROR 1 

; 1 
; HANDLES CATASTROPHIC INTERFACE ERRORS. I 

• THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 1 

REGISTER ! ACCESS 1 USAGE i 

DS ! CONST ! LO MEMEORY SEGMENT i 

; DX 1 DESTROY 1 INTERNAL 1 

; AX ! DESTROY 1 INTERNAL 1 

0249 CATASTROPHIC_ERROR PROC NEAR 

; IF LANA OWNS INTERFACE (WITH GO SET). SET CPLT_C0DE TO "CANT_CPLT?" 


0249 BA 0360 
024C EC 
024D A8 80 
024 F 75 09 
0251 A8 01 
0253 74 05 

0255 24 F9 


MOV DX, LANA_0_SR 

I N AL, DX 

TEST AL.HC 

JNZ SET_SPCL 

TEST AL.GO 

JZ SET_SPCL 

AND AL,ALL_B1TS-CPLT_C0DE 


DOES LANA OWN INTERFACE? 

IF NOT, DON'T SET CPLT_C0DE 
IS LANA WAITING ON THE PC? 

IF NOT, DON'T SET CPLT_CODE 
ELSE, MASK OFF AREA OF INTEREST 
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0257 OC 04 

0259 EE 

025A 

025A 80 OE 00A2 04 

025F C3 

0260 


OR 

OUT 

; REPORT 


SET_SPCL; 


AL.CANT_CPLT? 

DX,AL 

HARDWARE ERROR 


; AND SET AS DESIRED 


OR BYTE PTR DS: [ LANA_0_STATUS), LANA_HARD_ERR 

; RETURN 

RET 

CATASTROPHIC_ERROR ENDP 


ADDR_AND_LEN 

GETS A 32-BIT ADDRESS AND 16-BIT LENGTH FROM LANA_0'S PR PORT. 
THE 32-BIT ADDRESS IS GONVERTED INTO A SEGMENT ; OFFSET PAIR. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER : ACCESS \ USAGE 

DX I CONST : LANA'S PR PORT AODR 

ES:0I I RESULT ! ADDRESS IN SEGMENT: OFFSET FORM 

CX ! RESULT I LENGTH 


0260 ADDR_AND_LEN PROG NEAR 

SAVE <AX> 

0260 50 + PUSH AX 

; GET 32-BIT ADDRESS 


0261 EC 

0262 8A C8 

0264 81 El OOOF 

0268 8B F9 
026A 8A C8 
026C EC 

0260 8A E8 
026F F8 
0270 D1 E9 
0272 D1 E9 
0274 D1 E9 
0276 D1 E9 

0278 EC 

0279 8A EO 
027B EC 
027C D1 EO 
027E D1 EO 

0280 D1 EO 

0282 D1 EO 
0284 25 FOOO 

0287 03 Cl 

0289 8E CO 


IN AL.DX 

MOV CL,AL 

AND CX,000FH 

MOV D I , CX 

MOV CL,AL 

I N AL, DX 

MOV CH.AL 

CLC 

SHR CX, 1 

SHR CX, 1 

SHR CX, 1 

SHR CX, 1 

IN AL,DX 

MOV AH,AL 

IN AL,DX 


SHL AX, 1 

SHL AX,1 

AND AX,0F000H 

ADD AX,CX 

MOV ES,AX 

: GET 16-BIT LENGTH AND RETURN 


Dl GET LOWEST 4 BITS OF ADDR 


CX GET NEXT 12 BITS (TOP 4 BITS=0) 


AX BECOMES SEGMENT TYPE ADDR 


028B EC 
028C 8A C8 
028E EC 
028 F 8A E8 


IN AL.DX 
MOV CL,AL 
IN AL.DX 
MOV CH.AL 


RESTORE <AX> 

0291 58 + POP AX 

0292 C3 RET 


0293 ADDR_ANO_LEN ENDP 

0293 NETWORK ENDS 

END 

TITLE LANA_1 INTERRUPT HANDLER 
; LANA_1.ASM 

; LANA 1’S INTERRUPT HANDLER. 


MODULE : LANA_1 HNOLR 
COMPONENT : NETWORK BIOS 

HANDLES THE LANA_1 ( I RQ2 OR I RC|3 ) INTERRUPT. VALID REASONS FOR A LANA 
INTERRUPT ARE: 

DMA COMPLETE 

COMMAND COMPLETE --> COULD CAUSE A NETBIOS POST 
LANA REQUEST FOR DATA FROM PC 
LANA REQUEST TO XFER DATA TO PC 


ALL REGISTERS AND FLAGS ARE PRESERVED. 

NETBIOS. LIB CONTAINS THE NETBIOS INTERFACE EQUATES AND STRUCTURES 
LANAS. INC CONTAINS THE LANA INTERFACE EQUATES AND STRUCTURES 


0000 


NETWORK SEGMENT PARA PUBLIC 'CODE' 


ASSUME CS: NETWORK 
ASSUME DS: NOTHING 
ASSUME SS: NOTHING 
ASSUME ES: NOTHING 


EXTRN DMA_START_UP : NEAR 

PUBLIC LANA_1_HNDLR ; NEAR 


; STARTS UP A DMA XFER WITH A LANA 
; LANA 1'S INTERRUPT HANDLER 


ALL_BITS EQU OFFH 


AID TO MASKING OFF BITS 


= 0020 
= 0020 


THE_8259 EQU 20H 

EOl EQU 20H 


8259 PORT TO SEND EOl CMD TO 
CMD CODE FOR EOl 
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AMOUNT OF TIME TO WAIT ON INTERFACE 
MAX. SIZE OF A PROGRAM l/O'D "CHUNK" 

= 9180 DEV_BUSY_POST EQU 9180H 


CHUNK_SIZE 


LANA_1_HNDL.R 

HANDLES THE LANA_1 ( I RQ2 OR I RQ3 ) INTERRUPT. VALID REASONS FOR A LANA 
INTERRUPT ARE: 

DMA COMPLETE 

COMMAND COMPLETE --> COULD CAUSE A NETBIOS POST 
LANA REQUEST FOR DATA FROM PC 
LANA REQUEST TO XFER DATA TO PC 


ALL REGISTERS AND FLAGS ARE PRESERVED. 


0000 

0001 

0002 


0003 

0004 
0007 


LANA_1_HNDLR PROC 

SAVE 

PUSH 

PUSH 

PUSH 


NEAR 

<AX, DX, DS> 


SET UP GLOBAL ASSUMPTIONS 
D 

iV AX, LO_MEM_.SEG 


ALL STRINGS GO UP 

CHANGE TO L0_MfM_SEG LATER < 
DS PTS TO LANA RESERVED MEMORY 


TELL THE 8259 TO START LATCHING THIS INTERRUPT AGAIT 


OOOD 

0010 

0012 


i STATUS (JUST ONCE H 


ONCE MORE IF CLR GO) 

; GET THIS LANA'S STATUS PORT ADDR 


0016 

0018 

0019 


PUSH 

OR 

JMP 

POP 


AL,80H 

$+2 

DX,AL 


; ACKNOWLEDGE INTERRUPT TO LANA 


F6 06 00A3 08 


0021 

0026 

0028 

002A 

002F 


80 26 00A3 F7 
A8 06 
74 7F 

80 OE 00A3 04 
EB 78 90 


GOT NCB. SET COMPLETE CODE. EXIT 

BYTE PTR DS: [ LANA_1_STATUS1,ALL__BITS-LANA_ 

AL,CPLT_CODE 

LANA_EXIT 

BYTE PTR DS: [ LANA_1_STATUS], LANA_HARD__ERR 
LANA_EXIT 


GETT I NG_NCB 


0036 8A EO 
0038 BA 036B 
003B EC 
003C 24 41 

003E 22 C4 

0040 74 67 


0042 F6 C4 01 
0045 74 3B 


IGNORE UN-ENABLED INTERRUPTS 

V AH,AL 

V DX, LANA_1_HIR 
AL,DX 

D AL,TCI+GI 

D AL,AH 

LANA_EXI T 

INSURE THIS ISA "REAL" INTERRUPT 
TEST 


JZ 
; MAYBE. 
TEST 


INF BAD 
DMA COMPLETE 
AH, TC 

LANA_REQUEST 
RELEASE DMA 


NTERRUPT? 


; LANA MUST BE ASKING PC TO DO ^ 


; DMA TERMINAL COUNT REACHED? 


0056 BA 036B 
0059 EC 
005A 24 8F 

005C EB 00 
005E EE 
005F EB 3F 90 


0062 

0062 BA 0369 
0065 EC 


DISABLE DMA COMPLETE INTERRUPTS (IN CASE SOMEONE ELSE I 


AND 

JMP 

OUT 

JMP 


DX, LANA_1 
AL,DX 
AL, ALL_BI 
$+2 


GET CURRENT PC 
TURN OFF "TERMI 


NTERFACE REGISTER 
lAL COUNT" INTERRUPT ENABLE 


CLEAR_GO 

NOT DMA COMPLETE. GET THE CODE FOR THE CMD THAT LANA REQUESTS 


; IS IT A "REQUEST DATA TO/FROM LANA" CMD? 

CMP AL, DATA_TO_LANA 

JE DATA_REQ 

CMP AL, DATA_FROM_LANA 

JE DATA_REQ 


; NOPE. 
CMP 


MAYBE A "NCB COMPLETE" THEN? 


ERROR REPORT FROM LANA 
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0072 

0074 

0076 

0077 

0078 
007B 
007C 
007D 


80 OE 00A3 02 


0082 E8 0249 R 


0085 BA 0368 

0088 EC 

0089 A8 80 

008B 74 13 

008D EB 1A 90 


PUSH 

MOV 

OUT 

POP 

OR 


AL, ERROR_FROM_LANA 
I NT_BAD 
AL, OX 


DX 


BYTE PTR DS:[LANA_1_STATUS1,LANA_HARD_ERR1 
NTERRUPT. CATASTROPHIC ERROR! 
CATASTROPHIC^ERROR 


; I NVAL 1 0 
CALL 

; DETERMINE WHETHER TO CLEAR GO 

MOV 
IN 

TEST 


DX, LANA_1_SR 
AL,DX 
AL,HC 
CLEAR_GO 
JMP LANA_EXIT 


GET THIS LANA'S STATUS PORT VALUE 
DOES LANA OWN INTERFACE? 

I F YES. CLEAR_GO 


HANDLE "NCB COMPLETE" CODE 


0096 E8 0167 R 


; PROCESS "REQUEST DATA TO/ FROM LANA' 
CALL LANA_DATA_REQ 

; DON’T CLEAR GO IF USING DMA 


; CLEARS GO I 
CMD 


0099 F6 06 00A3 20 
009E 75 09 


TEST BYTE PTR DS: [ LANA_1_STATUS ] , LANA_DMA I NG 

JNZ LAN A_ EX IT 


; TELL LANA REQUEST IS COMPLETE 


OOAO BA 0368 
OOA3 EC 
00 A4 24 FE 
00A6 EB 00 
00 A8 EE 


CLEAR_GO; 


MOV 

IN 

AND 

JMP 

OUT 


DX, LANA_1_SR 
AL,DX 

AL,ALL_BITS-GO 

$+2 

DX,AL 


GET CURRENT SR PORT VALUE 
TURN OFF THE GO BIT 


; INTERRUPT RETURN 


00A9 

00A9 1 F 

OOAA 5A 
OOAB 58 
00 AC CF 


LANA_EXIT: 


OOAD 


LANA_1_HNDLR ENDP 


COMMAND_CPLT 

PROGRAM I/O'S THE NCB (OF THE COMPLETED CMD) OVER FROM THE LANA. 
IF THE NCB IS NO-WAIT TYPE, THE POST ROUTINE IS INVOKED. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER I ACCESS 1 USAGE 

DS ; CONST 1 LO MEMEORY SEGMENT 

DX 1 DESTROY | LANA'S PR PORT ADDR 

AX 1 DESTROY 1 INTERNAL 

INTERRUPTS SHOULD BE MASKED ON ENTRY. 

NOTE: CLEARS GO INTERNALLY. 


OOAD 


COMMAND_CPLT PROC NEAR 


OOAD 06 
OOAE 53 
OOAF 57 
OOBO 51 
00B1 56 


PUSH 

PUSH 

PUSH 

PUSH 

PUSH 


<ES,BX,DI,CX,SI> 


; LOCK INTERFACE & ENABLE INTERRUPTS 


00B2 80 OE 00A3 40 OR BYTE PTR DS: ( LANA_1_STATUS ] , LANA_LOCKED 

00B7 FB ST I 


; GET NCB'S DESTINATION ADDR & LENGTH 


00B8 E8 0260 R 
OOBB 26: C4 7D 34 

OOBF 57 


CALL ADDR_AND_LEN 

LES DI,ES:[DI 1.NCB_RESERVE_NCB0 ; GET REAL NCB ES:BX 

SAVE <DI> ; SAVE BASE OF NCB FOR LATER 

PUSH Dl 


; SETUP INTERFACE FOR PROGRAMMED I/O FROM LANA 


OOCO BA 036B 
00C3 EC 
00C4 24 C7 

00C6 OC 00 
00C8 EB 00 
OOCA EE 


MOV DX, LANA_1_HIR 

IN AL,DX ; GET CURRENT INTERFACE SETUP 

AND AL.ALL_BITS-IO_METHOD-DD_BIT ; MASK OFF BITS OF INTEREST 

OR AL, PROGRAMMED_IO+LANA_TO_PC ; AND SET THEM AS WE WANT IT 

JMP $+2 

OUT DX,AL 


SETUP TO READ IN THE NCB FROM THE LANA 


OOCB BA 036A 
OOCE BE 0368 
00D1 B4 20 


MOV DX,LANA_1_DR 
MOV SI,LANA_1_SR 
MOV AH.DRF 


; WAIT FOR (THE NEXT) BYTE OF NCB 


00D3 

0003 87 F2 

00D5 EC 
00D6 84 C4 

0008 74 09 


NEXT_NCB_BYTE: 

XCHG SI,DX 

IN AL.DX 

TEST AL,AH 

JZ NCB_N0T_READY 


IS IT READY? 

IF NOT, JMP TO WAITER 


; GET AND STORE BYTE 


OODA 

OODA 87 D6 
OODC EC 
OODD AA 


GET_NCB_BYTE: 

XCHG DX,SI 
IN AL.DX 
STOSB 
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LOOP IF MORE NCB TO READ IN 


30E3 

30E3 

30E6 

30E6 

30E7 

30E9 

DOEB 

OOEC 


OOEE E8 0249 R 


00F1 

00F2 

00F7 


BYTE NOT READY. WAIT UP TO "AWHILE" FOR IT 


NCB_NOT_READY; 

MOV 

NCB_N0T_READY2; 

TEST 

JNZ 

DEC 

JNE 


AL.DX 

AL,AH 

GET_NCB_BYTE 
BX 


NCB_N0T_READY2 
; TIMEOUT WHILE WAITING. CATASTROPHIC ERROR! 
CALL CATASTROPH I C_ERROR 

; SET NCB RETURN CODE TO NCBSYS_ERR? 

<BX> 


RESTORE 

POP 

MOV 

JMP 


BX 


SAVED FROM Dl 


; NCB TRANSFERRED. 
NCB_XFERD; RESTORE <BX> 


GET NCB BASE ADDRESS 


SAVED FROM Dl 


OOFB 
00 FC 
0101 

0104 

0105 
0107 
0109 


26; 88 47 38 
26: 89 47 04 
26: 8B 47 3A 
26: 89 47 06 


MASK INTERRUPTS, UNLOCK INTERFACE, TELL LANA WE'RE DONE 

:li 

VND BYTE PTR DS: ( LANA_1_STATUS 1 , ALL_B I TS-LANA LOCKED 

lOV DX, LANA_1_SR 

N AL,DX 

AL,ALL_BITS-GO 


AND 

JMP 

OUT 


DX,AL 

RESTORE BUFFER© TO SEC: OFF TYPE ADDR 


MOV 

MOV 

MOV 

MOV 


AX, ES-.WORD PTR ( BX ) . NCB_RESERVE_BUFFER@ 
ES:WORD PTR ( BX J . NCB_BUFFER@, AX 
AX, ES:WORD PTR ( BX ) . NCB_RESERVE_BUFFERe+2 
ES:WORD PTR ( BX] . NCB_BUFFERe+2,AX 


IF NCB FOR MULTIPLE SEND RESTORE SECOND BUFFER© TO SEC: OFF TYPE ADDR 


MOV 

AND 

CMP 

JNZ 


AL, ES: [ BX] . NCB_COMMAND 
AL,7FH 

AL, NCBSENDMULTI PLE 
UDT_RCD 


0123 

0127 

012B 

012F 


8B 47 3C 
89 47 OC 
8B 47 3E 


AX, ES: WORD PTR [ BX ] . NCB_RESERVE_B0FFER2@ 
ESiWORD PTR [BX].NCB_BUFFER@+8,AX 
AX,ES:WORD PTR [ BX ] . NCB_RESERVE_BUFFER2e+2 
ES.-WORD PTR [BX].NCB_BUFFER@+OAH,AX 
UPDATE NCB_CMD_CPLT 


MOV 

MOV 

MOV 

MOV 


DO WE POST THIS NCB? 


013B 

013F 

0141 

0144 

0146 

0147 

014A 

014F 

0151 

0156 


26: F6 07 ( 
75 09 
B8 9180 
CD 15 


26: 83 7F 2C 00 
75 07 

26: 83 7F 2E 00 
74 09 


TEST 

JNZ 

MOV 


CMP 

JNZ 

CMP 


ES:BYTE PTR [ BX] . NCB_COMMAND, NCBNO_W/ 
N0_WAIT? 

AX, DEV_BUSY_POST 


ESiWORD PTR [BX].NCB_POST@,OOOOH 
POST 

ES;WORD PTR [ BX) . NCB_POST@+2,OOOOH 
CMD_EXIT 


YES. GET RETCODE & POST (AS AN INTERRUPT) 


0158 26: 8A 47 01 

015C 9C 

015D 26: FF 5F 2C 


0161 

0161 5E 

0162 59 

0163 5F 

0164 5B 

0165 07 

0166 C3 


0167 


MOV 

PUSHF 

CALL 

; RETURN 
RESTORE 


RET 

COMMAND_CPLT ENDP 


AL, ES: I BX] .NCB_RETCODE 
ES: DWORD PTR [ BX] . NCB_POST@ 


<SI ,CX, Dl , BX, ES> 


LANA_DATA_REQ 

SETS UP «e STARTS A TRANFER OF DATA BETWEEN THE PC AND THE LANA. 

WHILE DMA IS BUSY, THE PC WILL XFER "CHUNKS" VIA PROGRAMMED I/O. 

WHEN DMA IS FREE, A DMA XFER OF THE REMAINDER WILL BE SETUP AND STARTED. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 


REGISTER ! ACCESS 

DS ! CONST 

DX ! DESTROY 

AL ! DESTROY 

AH ! DESTROY 


! OSAGE 

: LO MEMEORY SEGMENT 
! LANA’S PR PORT ADDR 
I CMD CODE OF LANA REQUEST 
! INTERNAL 


INTERRUPTS SHOULD BE MASKED ON ENTRY. 


0167 


LANA_DATA_REQ PROC NEAR 


SAVE <CX,ES,0I> 
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0167 51 

0168 06 

0169 57 


01 6A 8A EO 


01 6C 80 OE 00A3 40 


0171 E8 0260 R 


0174 BA 036B 

0177 EC 

0178 24 C7 

01 7A 80 FC 44 
0170 75 05 

017F OC 08 
0181 EB 03 90 
0184 OC 00 
0186 EE 


0187 F6 06 00A1 80 
018C 74 18 


018E FB 
018F E8 0169 R 
0192 FA 


0193 F6 06 00A3 04 
0198 75 16 


019A 83 F9 00 

019D 74 11 


PUSH CX 

PUSH ES 

PUSH Dl 

; SAVE CMb CODE FOR LATER 

MOV AH,AL 

; LOCK INTERFACE 

OR BYTE PTR DS ; [ LANA_1_STATUS ] , LANA_LOCKED 

; GET DATA'S PC ADDR & LEN 

CALL ADDR_AND_LEN 

; SETUP FOR PROGRAMMED I/O (MAY LATER CHANGE TO DMA) IN THE CORRECT DIRECTION 

MOV DX,LANA_1_HIR 

IN AL,DX 

AND AL,ALL_BITS- IO_METHOD-DD_BIT 

CMP AH,DATA_TO_LANA 

JNE FROM_LANA 

OR AL, PROGRAMMED_IO+PC_TO_LANA 

JMP DIR_SET 

FROM_LANA: OR AL, PROGRAMMED_ I 0+LANA_T0_PC 

DIR_SET: OUT DX,AL 

; DMA_3 BUSY? 

TRY_DMA_3: TEST BYTE PTR DS : [ LANA_HARDWARE ] , DMA_3_BUSY 

JZ GET_DMA_3 

; YEP. PROGRAM I/O A "CHUNK" 

PROGRAM_IO:STI ; ALLOW INTERRUPTS Sc HOPE THAT DMA FREES UP 

CALL PROGRAM_IO_CHUNK 

CLI 

; CATASTROPHIC ERROR HAPPEN? 

TEST BYTE PTR DS: [ LANA_1_STATUS ] , LANA_HARD_ERR 

JNZ DATA_EXIT ; I F SO, EXIT 

; NOPE. MORE DATA LEFT TO XFER? 

CMP CX, 0 

JZ DATA_EXIT ; IF NOT, EXIT 

; YES. WORTH TRYING FOR DMA? 


; GET CURRENT INTERFACE SETUP 
; MASK OFF AREA OF INTEREST 
; IS IT TO OR FROM THE LANA? 

; TO LANA 
; FROM LANA 


019F 83 F9 70 

01A2 73 E3 

01A4 EB E8 

; SETUP Sc START DMA (OF REMAINING DMA) 


CMP CX,CHUNK_SIZE 

JNB TRY_DMA_3 

JMP PROGRAM_IO 


01A6 BA 036B 
01A9 50 

0 1 AA BO 02 
01 AC E8 0000 E 
01AF 58 


GET_DMA_3 : MOV DX, LANA_1 _H I R 

PUSH AX 

MOV AL,02 ; INDICATES LANA 2 REQUESTING DMA SERVICE 

CALL DMA_START_UP 

POP AX 

; UNLOCK INTERFACE AND RETURN 


01 BO 80 26 00A3 BF DATA_EXIT: 


01B5 5F 
01B6 07 

01B7 59 

01B8 C3 


AND BYTE PTR DS:[ 

RESTORE <DI,ES,CX> 
POP Dl 

POP ES 

POP CX 


I , ALL_B I TS-LANA_LOCKED 


01B9 


LANA_DA1 


;q ENDP 


PROGRAM_IO_CHUNK 

PROGRAM I/O'S A "CHUNK" OF THE REMAINING DATA BETWEEN THE PC «e LANA. 
THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER I ACCESS I USAGE 


DS ; CONST LO MEMEORY SEGMENT 

AH I CONST I CMD CODE OF LANA REQ 

ES:DI I VAR 1 START OF "CHUNK" IN MEMORY 

CX ; VAR i LENGTH OF REMAINING DATA 

DX 1 DESTROY I INTERNAL 

INTERRUPTS SHOULD BE UNMASKED ON ENTRY. 


01B9 PROGRAM_IO_CHUNK PROC NEAR 

SAVE <SI,AX,BX> 

+ PUSH SI 

+ PUSH AX 

+ PUSH BX 

; SETUP CHUNK SIZE, DATA PORT ADDR, UPDATE "REMAINING DATA" SIZE 

MOV DX,CHUNK_SIZE ; THIS_CHUNK := M I N( CHUNK_S I ZE, REMA I N I NG_DATA ) 

CMP CX,DX 

JNB GOT_CHUNK 

MOV DX,CX 

GOT_CHUNK: SUB CX,DX ; REMA I N I NG_DATA := REMA I N I NG_DATA - THIS_CHUNK 

SAVE <CX> 

PUSH CX 

MOV CX,DX 

MOV DX, LANA_1_DR 

; DATA TO LANA? 

CMP AH,DATA_TO_LANA 

JNE FR0M_LANA2 

; YEP. SETUP SOURCE PTR & PORT ADDRS 

01 02 8B F7 MOV SI,DI 

SWAP ES,DS 

01 D4 06 + PUSH ES 

01D5 IE + PUSH DS 

01D6 07 + POP ES 


01CD 80 FC 44 
01D0 75 4F 


OIBC BA 0070 
OIBF 3B CA 
01C1 73 02 

01C3 8B Dl 
01C5 2B CA 

01C7 51 

01 C8 8B CA 
01 CA BA 036A 


01B9 56 

01BA 50 
01BB 53 
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0108 BF 0368 
010B B4 10 
0100 EB OA 90 


01 EO 87 FA 
01 E2 EC 
01 E3 84 C4 


01FB 06 
01 FC IE 
OlFO 07 
01FE IF 
01FF 88 FE 
0201 EB 3E 90 


OOT_TO_LANA: 

XCHG 

0UT_T0_LANA2 : 

LODSB 


NO_ROOM: MOV 

ROOM NOW? ; I N 

1 EST 


■ MORE "CHUNK" 10 SENO 


TIMEOUT EXPIRED? 

I F NOT, TRY AGAIN 

RESTORE REGISTERS TO "ON ENTRY" SETUP 


. OF THE "CHUNK" YET? 


RESTORE REGISTERS TO "ON ENTRY" SETUP 


0226 87 06 

0228 EC 

0229 84 C4 


022F EC 

0230 AA 

0231 E2 F3 


DATA REGISTER TOTALLY EMPTY? 
I F SO, CHUNK I S DONE 
TIMEOUT EXPIRED? 

I F NOT, TRY AGAIN 


0236 BB 000 
0239 EC 
023A 84 C4 

023C 76 EF 


TIMEOUT WAITING ON I/O. CATASTI 


DATA BYTE WAITING NOW? 
I F SO, CO GET IT 
TIMEOUT EXPIRED? 

I F NOT, TRY AGAIN 


CATASTROPHIC_ERROR 

HANDLES CATASTROPHIC INTERFACE ERRORS. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED; 

REGISTER I ACCESS 1 USAGE 

DS 1 CONST 1 LO MEMEORY SEGMENT 

DX 1 DESTROY 1 INTERNAL 
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AX 1 DESTROY ! INTERNAL 


0249 


CATASTROPHIC_ERROR PROG NEAR 


; IF LANA OWNS INTERFACE (WITH GO SET), SET CPLT_C0DE TO "CANT_CPLT?" 


0249 BA 0368 
024C EC 
024D A8 80 
024F 75 09 

0251 A8 01 
0253 74 05 

0255 24 F9 

0257 OC 04 
0259 EE 


MOV DX,LANA_1_SR 

IN AL,DX 

TEST AL,HC 

JNZ SET_SPCL 

TEST AL,GO 

JZ SET_SPCL 

AND AL,ALL_BITS-CPLT_CODE 

OR AL,CANT_CPLT? 

OUT DX,AL 


DOES LANA OWN INTERFACE7 
IF NOT, DON'T SET CPLT_CODE 
IS LANA WAITING ON THE PC? 

IF NOT, DON'T SET CPLT_C0D£ 
ELSE, MASK OFF AREA OF INTEREST 
AND SET AS DESIRED 


; SET LANA'S LANA_HARD_ERR 


025A 


SET_SPCL: 


025A 80 OE 00A3 04 


OR BYTE PTR DS: [ LANA_1_STATUS] , LANA_HARD_ERR 


; RETURN 


025F C3 


RET 


0260 


CATASTROPHIC_ERROR ENDP 


ADDR_AND_LEN 

GETS A 32-BIT ADDRESS AND 16-BIT LENGTH FROM LANA_1 ’ S PR PORT. 
THE 32-BIT ADDRESS IS CONVERTED INTO A SEGMENTrOFFSET PAIR. 

THE FOLLWING CONVENTIONS SHOULD BE FOLLOWED: 

REGISTER 1 ACCESS I USAGE 

DX 1 CONST ! LANA'S PR PORT ADDR 

EStDI 1 RESULT ! ADDRESS IN SEGMENT : OFFSET FORM 

CX 1 RESULT 1 LENGTH 


0260 AD0R_AND_LEN PROC NEAR 

SAVE <AX> 

0260 50 + PUSH AX 

; GET 32-BIT ADDRESS 


0261 EC 

0262 8A C8 

0264 81 El OOOF 

0268 8B F9 
026A 8A C8 
026C EC 

026D 8A E8 
026 F F8 
0270 D1 E9 
0272 D1 E9 
0274 D1 E9 
0276 D1 E9 

0278 EC 

0279 8A EO 
027B EC 
027C D1 EO 
027E D1 EO 

0280 D1 EO 

0282 D1 EO 
0284 25 FOOO 

0287 03 Cl 

0289 8E CO 


I N AL, DX 

MOV CL,AL 

AND CX.OOOFH 

MOV D I , CX 

MOV CL,AL 

IN AL,DX 

MOV CH,AL 

CLC 

SHR CX, 1 

SHR CX, 1 

SHR CX, 1 

SHR CX, 1 

IN AL,DX 

MOV AH,AL 

IN AL,DX 

SHL AX,1 

SHL AX, 1 

SHL AX,1 

SHL AX, 1 

AND AX,OFOOOH 

ADD AX,CX 

MOV ES,AX 


Dl GET LOWEST 4 BITS OF ADDR 


CX GET NEXT 12 BITS (TOP 4 BITS=0) 


AX BECOMES SEGMENT TYPE ADDR 


; GET 16-bit LENGTH AND RETURN 


028B EC 
028C 8A C8 
028E EC 
028F 8A E8 


IN AL,DX 
MOV CL,AL 
IN AL,DX 
MOV CH,AL 


RESTORE <AX> 

0291 58 + POP AX 

0292 C3 RET 


0293 ADDR_AND_LEN ENDP 

0293 NETWORK ENDS 

END 
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Appendix E. Multitasking 
Considerations 


If you use the wait option for the commands in a 
multitasking environment, a "hook" is provided for the 
multitasking program using interrupt 15H. When either 
a busy or wait loop occurs in NET BIOS, a "hook" is 
provided for the program to break out of the loop. To 
distinguish individual calls, look at the ES:BX register 
which points to the NCB. The "hook" is also used 
when NET BIOS is servicing an interrupt, that in turn 
causes a corresponding wait loop, providing a means to 
break out of the loop. The steps necessary to service 
interrupt 15H are as follows: 

When programming in the multitasking environment, 
the program has the responsibility to check the AX 
register for the following function codes: 
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AH contains: 

AL contains: 

90H 

80H 

91H 

80H 


Figure E-1 AX Register Function Codes 


The program must pass all other functions through to 
the previous user of interrupt 15H. This can be 
accomplished by either a JMP or a CALL. With either 
a 90H or 91H function code in the AH register, the 
program performs the necessary processing and returns 
using an IRET instruction. An 80H in the AL register 
indicates that NET BIOS issued the interrupt. 

9080H This function code is in the AX register 

whenever NET BIOS is about to enter either 
a busy or a wait loop. NET BIOS also issues 
an interrupt 15H at this time to signal the 
program of the loop. When this occurs, the 
program saves the task status and dispatches 
another task. This allows overlapping 
execution of tasks when the hardware is 
busy. 

9180H This function code is in the AX register 
whenever NET BIOS has set an interrupt 
flag for a corresponding busy loop. NET 
BIOS also issues an interrupt 15H at this 
time. This code is used to signal a POST 
condition and the program sets the task 
status to "ready to run" before returning. 
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active circuit. A circuit or device that requires electrical 
power to operate. 


address. A number specifying a particular user device 
attachment point. 

alias. An alternate name that you can be known by on 
the network. 

allocations. The assignments of frequencies by the FCC 
for various communications uses (for example; 
television, radio, land-mobile, defense, microwave, etc.) 
The assigned frequencies are to achieve a fair division 
of the available spectrum and to minimize interference 
among users. 

amplifier. A device used to boost the strength (dB 
level) of an electronic signal. Amplifiers are spaced at 
intervals throughout a cable system to rebuild the 
strength of TV or data signals that weaken as they pass 
through the cable network. Midsplit configurations use 
a forward and a reverse amplifier in the same enclosure 
to boost signals in both directions. 


balancing (signal). A method of equalizing the 
attenuation that a particular signal encounters through 
the network (forward direction) so that the signal level 
is essentially the same at all outlets. Balancing also 
produces near equal inputs to the frequency translator 
from a fixed level transmitter (reverse), no matter 
where the transmitter is attached to the network. 

bandwidth. A measure of spectrum (frequency) use or 
capacity. For instance, a voice transmission by 
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telephone requires a bandwidth of about 3000 cycles 
per second (3 kHz). A TV channel occupies a 
bandwidth of 6 million cycles per second (6 MHz). 


BIOS. Basic Input Output System. 


branch. An intermediate cable distribution line in a 
broadband coaxial network that either feeds or is fed 
from a main trunk. Also referred to as a feeder. 

bridge. A specialized device containing programs and 
network attachments. It is used to route messages 
between the same network, on a different broadband 
network or both. 

broadband. A general term used to describe wide 
bandwidth equipment or systems that can carry a large 
proportion of the electromagnetic spectrum. A 
broadband communications system can accommodate 
all broadcast and many other services. 


cable kit. An 8 -port splitter device used to connect the 
Personal Computers to the network. 

cable loss. The amount of rf signal attenuation by 
coaxial cable transmission. The amount of cable 
attenuation is a function of frequency and cable 
distance. High frequencies have a greater loss than low 
frequencies and follow a logarithmic function. Cable 
losses are usually calculated for the highest frequency 
carried on the cable. 


Cable powering. Supplying operating power to active 
CATV equipment by using the coaxial cable to carry 
this power along with the information signal. 


cable tilt. A reduction in the level of an RF sweep 
signal passing through a cable as it sweeps from low to 
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high frequency. This "tilt" is caused by the increase in 
cable attenuation as the frequency increases. A specific 
fixed length of cable and a fixed frequency range 
produces a fixed amount of tilt. 


Cable TV. Previously called Community Antenna 
Television (CATV). A communication system that 
distributes broadcast programs simultaneously via a 
coaxial cable. 


carrier sense multiple access with collision detection 
(CSMA/ CD). A technique by which many 
independent nodes can share a co mm on broadcast 
communication channel without requiring a central 
transmission allocation authority. 


CATV. See Cable TV. 


composite video s^al. The complete video signal. For 
monochrome, it consists of the picture signal, blanking 
and synchronizing signals. For color, additional color 
synchronizing signals and color picture information are 
added. 

coaxial cable. Coaxial means that two conductors and 
the dialectic share the same axis - the center of the 
cable. One conductor is the center wire, while the 
other is the shield and is referenced to ground. The 
shield and center conductor are separated by an 
insulating dialectic made of polyethylene. 


CRC. See cyclic redundancy check. 


cross modulation. A form of signal distortion in which 
modulation from one or more RF carrier(s) is imposed 
on another carrier. 
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CSMA/ CD. See carrier sense multiple access with 
collision detection 


cyclic redundancy check. A numeric value derived from 
the bits in a message that is used to check a message for 
any bit errors in transmission. 


datagram. A particular type of information 
encapsulation at the network layer of the adapter 
protocol. No explicit acknowledgment for the 
information is sent by the receiver. Instead, 
transmission relies on the "best effort" of the link layer. 

data rate. The rate at which data is transferred within a 
processor and between a processor and an external 
device. This rate is usually expressed in units of bits 
per second (bps). 

dB. An abbreviation for decibel, used as a relative unit 
of measure between two signals on a logarithmic basis. 
dB is an expression of a ratio between an input level 
and an output level. 

dBmV. An abbreviation for decibel millivolt. The level 
at any point in a system expressed in dB’s above or 
below a 1 millivolt/75 ohm standard is the level in 
decibel millivolts (dBmV). Zero dBmV is equal to 1 
millivolt across 75 ohms. 

default. The default value of a setting is the original 
one, which is in effect until other instructions are 
entered. 

directional coupler. A high quality tapping device 
providing isolation between a single tap outlet drop line 
and external devices (can be more than one). 

distribution amplifier. An amplifier used to increase rf 
signal levels to overcome cable and flat loss for user 
distribution. 
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DMA. Direct Memory Access. 


drop cable. A flexible coaxial cable that extends from a 
tap on the coaxial network. The end of the drop cable 
has the network outlet connector, which is used to 
attach an external device. Also referred to as a drop 
line. 

drop-line device. Any external device attached to the 
coaxial network through a drop cable, for example a TV 
set, audio modulator, or adapter. 


echo. See reflections. 

equalization. A means of modifying the frequency 
response of an amplifier or network, thereby resulting 
in a flat overall response. It is slope compensation done 
by a module within an amplifier enclosure. 


F connector. A type of connector used by the CATV 
industry to connect a coaxial cable to equipment. 

FDM. Frequency Division Multiplex. See frequency 
division multiplexing. 


feeder (cable). Same as a branch. 

filter. A circuit that selects one or more components of 
a signal depending on their frequency. Used in trunk 
and branch lines for special cable services such as 
two-way operation. 

flat loss. Equal loss at all frequencies, such as that 
caused by attenuators. 

flooded cable. A special CATV cable containing a 
corrosion-resistant gel between the outer aluminum 
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sheath and the outer jacket. The gel flows into 
imperfections in the aluminum to prevent corrosion in 
high moisture areas. 

forward direction. The direction of signal flow away 
from the frequency translator. 

frequency. The number of times an electromagnetic 
signal repeats an identical cycle in a unit of time, 
usually one second. One Hertz (Hz) is one cycle per 
second. A kHz (Kilohertz) is one thousand cycles per 
second; a MHz (Megahertz) is one million cycles per 
second; a GHz (Gigahertz) is one billion cycles per 
second. 

frequency division multiplexing. A method of dividing a 
communication channel bandwidth among several 
subchannels with different carrier frequencies. Each 
subchannel can carry separate data signals. 

frequency response. The change of gain with frequency. 

frequency translator. In a mid-split configuration, an 
active electronic circuit in the headend that picks up 
information signals on one 6 MHz channel, coming in 
from the reverse direction — converts them to another 6 
MHz channel above the mid-split frequency and sends 
them out in the forward direction. 


FSK. Frequency Shift Keying. 


full duplex. A connection on the network that allows 
transmissions in both directions at the same time. 


gateway. A protocol-translating interface between an 
adapter (and its protocols) and an external network 
that uses a distinctly different protocol suite. 
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harmonic distortion. Form of interference involving the 
generation of harmonics according to the frequency 
relationship f = (n)f for each frequency present, where 
n is a whole number equal to 2i or more. 

headend. The location of the frequency translator or an 
electronic control center, generally located at the 
antenna site of a CATV system, usually including 
antennas, preamplifiers, frequency converters, 
demodulators, modulators and other related equipment 
that amplify, filter and convert incoming broadcast TV 
signals to cable system channels. See also frequency 
translator. 

high frequencies. Frequencies from 160MHz to 
400MHz allocated for the forward direction in a 
mid-split system. 

host concept. Many protocols such as IBM’s SNA for 
example, employ some large data processing facility as 
part of the network. 

hub. The same as a headend for bidirectional networks, 
except that it is more centrally located within the 
network. 


insertion loss. Additional loss in a system when a device 
such as a directional coupler is inserted; equal to the 
difference in signal level between input and output of 
such a device. 

isolation loss. The amount of signal attenuation in a 
passive device from input port to tap outlet port. 


LAN. Local Area Network. 

LANA. Local Area Network Adapter. 
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local session number. The number assigned to each 
session established by an adapter. Each session 
receives a unique number that distinguishes it from any 
other active sessions. 

low frequencies. Frequencies from 5MHz to 1 16MHz 
allocated for the return direction in a mid-split system. 


LSN. See local session number. 


main trunk. The major link(s) from the headend (or 
hub) to downstream branches. 

message. A message is a logical partition of the user 
device’s data stream to and from the adapter. 

mid-band. The part of the frequency band that lies 
between television channels 6 and 7, reserved by the 
FCC for air, maritime and land mobile units, FM radio 
and aeronautical and maritime navigation. Mid-band 
frequencies, 108 to 174 MHz, can also be used to 
provide additional channels on cable television systems. 

mid-split. A method of frequency division that allows 
two-way traffic on a single cable. Incoming signals go 
to the frequency translator between 5-1 16MHz; 
outgoing signals go from the frequency translator 
between 168-400MHz. No signals are present between 
11 6- 162MHz. 

multitap. A passive distribution component composed 
of a directional coupler and a splitter with two or more 
output connections. 


node. Consists of a personal computer, an adapter with 
a cable and other adapters to the Personal Computer 
(such as; disk drives, printers, and plotters). Along 
with the Personal Computer hardware, the necessary 
software must be available. 
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noise. The word "noise" is a carry-over from audio 
practice. Refers to random spurts of electrical energy 
or interference. 

noise figure. A measure of the amount of noise in dB 
generated at the input of an amplifier as compared with 
the noise generated by a 7 5 -ohm resistor. 


packet. A unit of the protocol used by the transport 
layer. The packet contains header control information, 
as well as user data. 

parity. The checksum of each data byte transmitted or 
received. Each 1 bit is counted in a byte. The number 
of odd or even 1 bits in the byte is the parity. Parity 
may be even, odd, or none. 

passive circuit. A circuit or device that does not require 
electrical power to operate. 

point-to-point. A connection between two and only 
two nodes on a network. 


PROM. Programmable Read Only Memory. 


protocol. A procedure for ordering the exchange of 
formatted information packets between correspondents. 
Protocols are “interpreted” by hardware and software 
within the adapter. See the protocol section in Chapter 
2 . 


RAM. Random Access Memory. 


receiver isolation. The attenuation between any two 
receivers that are connected to the system. 

rf. Radio frequency. 
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rf modem. A modulator-demodulator device that codes 
or decodes a digital information signal. The modulator 
part of the rf modem codes the digital information onto 
an analog signal by varying the frequency of the carrier 
signal. The demodulator part extracts the digital 
information from a modulated carrier signal. 

reflections. Signal waves reflected from components 
within the network, which are the result of impedance 
or mismatches in the transmission coax medium. Also 
called echoes. 

return loss. Reflection coefficient expressed in dB. 

return path. See reverse direction. 

reverse direction. The direction of signal flow toward 
the frequency translator. 

reverse path. See reverse direction. 


ROM. Read Only Memory. 


session. The data transport connection resulting from a 
call between two user devices. 

signal ingress. This is a signal or signals that enter into 
the cable or cable system from an outside source, such 
as an RF transmitting tower (AM or FM). 

signal level. The root-mean-square (rms) voltage 
measured during the peak of the RF signal. It is usually 
expressed in microvolts referred to an impedance of 75 
ohms, or in dBmV. 

signal-to-noise ratio. The relative power of the signal to 
the noise on the cable. 
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slope. The difference between the signal levels at the 
highest frequency and the lowest frequency in a 
network. Slope is sometimes referred to as spectrum 
tilt. 

slope compensation. The action of a slope-compensated 
gain control. The gain of an amplifier and the slope of 
the amplifiers equalization circuit are simultaneously 
changed to provide the correct cable equalization for 
different lengths of cable. This is normally specified in 
terms of cable loss. 

splitter. A passive, 5 MHz-300 MHz or 800 MHz 
bandpass device. The device is coupled in-line to a 
main trunk or branch for splitting the power and the 
information signal two or more ways on a coaxial 
network. Splitters always pass through 60Hz power to 
the network, if used. 

subsplit. A method of frequency division that allows 
two-way traffic on a single cable. Incoming signals go 
to the frequency translator between 5-30MHz; 
outgoing signals go from the frequency translator 
between 54-400MHz. No signals occupy 30-54MHz. 


tap. A passive 5 MHz-300 MHz box-like device, 
normally installed in line with a broadband branch 
cable. Passive circuits tap off only the information 
signal to its small Type F outlet ports. 

tap outlet. A Type F connector port on a tap used to 
attach a drop cable. The information signal is carried 
through this port. The number of outlets on a branch 
line tap normally varies from 2 to 8. 


TDM. See time division multiplexing. 


terminator. A 7 5 -ohm resistive connector used to 
terminate the end of a cable or an unused tap. The 
device is used to minimize cable reflections. 
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tilt compensation. See slope compensation. 

time division multiplexing. A method of sharing a 
communication channel among several users by 
allowing each to use the channel for a given period of 
time in a defined, repeated sequence. 

trunk line. See main trunk. 


unity gain. A standard design parameter used in CATV 
network amplifiers. The amplifier is designed to 
compensate for cable signal loss and flat loss. It also 
implies that the output of any amplifier is equal to or 
less than the output of the previous cascaded amplifier 
(forward or reverse) in the network. 


virtual connection. A connection between two nodes on 
the network that is established using the transport layer 
and provides reliable data transfer between the nodes. 
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